Crear y ejecutar un proyecto de FacturaScripts

FacturaScripts es una solución ERP y CRM de código abierto, poderosa y flexible, ideal para pequeñas y medianas empresas y freelancers. Con el conveniente entorno de desarrollo local que ofrece ServBay, puede crear, probar y ejecutar proyectos de FacturaScripts fácilmente en su sistema local macOS.

Esta guía le llevará a través del proceso completo de instalación y configuración de FacturaScripts utilizando ServBay.

¿Qué es FacturaScripts?

FacturaScripts es un software de planificación de recursos empresariales (ERP) y gestión de relaciones con clientes (CRM) de código abierto, desarrollado con PHP y el marco Bootstrap. Está diseñado para ayudar a las empresas a gestionar sus procesos comerciales clave, que incluyen:

• Emisión y gestión de facturas
• Contabilidad
• Control de inventario
• Gestión de clientes y proveedores
• Gestión de proyectos
• ¡Y más!

Como un proyecto de código abierto, cuenta con un soporte comunitario activo y permite a los usuarios ampliar y personalizar sus funcionalidades mediante plugins.

Principales características y ventajas de FacturaScripts

• Código abierto gratuito: No es necesario pagar costosas licencias; se puede utilizar y modificar libremente.
• Funcionalidad integral: Cubre la mayoría de las funciones centrales necesarias para el funcionamiento diario de pequeñas y medianas empresas.
• Fácil de usar: La interfaz es relativamente intuitiva, con una curva de aprendizaje suave.
• Altamente escalable: Dispone de un rico mercado de plugins, permitiendo añadir nuevas funciones fácilmente o integrarse con otros servicios.
• Multiplataforma: Basado en la web, accesible desde cualquier dispositivo que soporte navegadores modernos.
• Comunidad activa: Puede recibir ayuda de la comunidad cuando se presentan problemas.
• Soporte multilenguaje: Compatible con varios idiomas, facilitando su uso a usuarios de diferentes regiones.

Crear y ejecutar un proyecto de FacturaScripts con ServBay

ServBay proporciona un entorno local ideal para ejecutar aplicaciones PHP como FacturaScripts. Integra Nginx/Apache, múltiples versiones de PHP, MySQL/MariaDB/PostgreSQL y otros servicios comunes, y ofrece una interfaz gráfica para su gestión.

Los pasos principales para ejecutar FacturaScripts con ServBay incluyen:

1. Descargar el código fuente de FacturaScripts.
2. Crear una carpeta de proyecto en el directorio gestionado por ServBay.
3. Crear la base de datos y el usuario de MySQL requeridos por FacturaScripts.
4. Configurar el servidor web Apache a través de ServBay para apuntar al directorio del proyecto.
5. Acceder a través del navegador y completar el asistente de instalación de FacturaScripts.

Crear un proyecto de FacturaScripts (basado en el paquete zip descargado)

Este es uno de los métodos más comunes para la instalación local.

1. Descargar FacturaScripts:

   • Visite el sitio web oficial de FacturaScripts (https://facturascripts.com/).
   • Navegue hasta la sección de descargas, encuentre la última versión estable del paquete .zip y descárguelo.

2. Crear el directorio del proyecto:

   • Abra Finder y navegue hasta el directorio donde ServBay almacena los archivos del sitio web. Por defecto, se recomienda ubicación en /Applications/ServBay/www/.
   • En este directorio, cree una nueva carpeta para almacenar el proyecto de FacturaScripts, nombrándola, por ejemplo, facturascripts_project.
   • Ejemplo de ruta completa: /Applications/ServBay/www/facturascripts_project

3. Descomprimir los archivos:

   • Descomprima el archivo .zip de FacturaScripts descargado en la recién creada carpeta facturascripts_project.
   • Después de descomprimir, la carpeta facturascripts_project debe contener archivos y directorios como index.php, config.php (puede generarse después de la instalación), Core, Dinamic, Plugins, entre otros.

Configuración inicial (configuración de la base de datos MySQL, etc.)

FacturaScripts necesita una base de datos para almacenar toda la información. Usaremos el servicio MySQL gestionado por ServBay.

1. Asegúrese de que el servicio MySQL esté en ejecución:

   • Abra la aplicación ServBay.
   • En el menú de la izquierda, seleccione "Servicios" - "MySQL".
   • Asegúrese de que el servicio de MySQL (o MariaDB) esté iniciado. Si no está en marcha, haga clic en el botón de alternancia al lado para iniciarlo.

2. Crear la base de datos:

   • Puede crear la base de datos usando la herramienta de gestión de bases de datos integrada en ServBay (como phpMyAdmin) o a través de la línea de comandos.
   • Usando phpMyAdmin (recomendado):
     • En la interfaz de ServBay, encuentre "Bases de datos" - "MySQL" y haga clic en phpMyAdmin en la parte superior derecha.
     • Inicie sesión en phpMyAdmin (normalmente usando el usuario root y la contraseña que configuró en ServBay).
     • Haga clic en la pestaña "Bases de datos".
     • En el campo "Crear base de datos", ingrese un nombre para la base de datos, por ejemplo, facturascripts_db.
     • Elija el conjunto de caracteres adecuado, recomendando utf8mb4_general_ci o utf8mb4_unicode_ci.
     • Haga clic en "Crear".
   • Crear un usuario de base de datos (opcional pero recomendado): Por razones de seguridad, se recomienda crear un usuario de base de datos dedicado para FacturaScripts, en lugar de usar el usuario root.
     • En phpMyAdmin, vuelva a la página principal y haga clic en la pestaña "Cuentas de usuario".
     • Haga clic en "Agregar cuenta de usuario".
     • Ingrese un nombre de usuario (por ejemplo, facturascripts_user).
     • Seleccione localhost como nombre de host.
     • Genere o ingrese una contraseña segura, y asegúrese de recordar esta contraseña.
     • Marque "Crear una base de datos con el mismo nombre que el usuario y otorgar todos los privilegios" o dirígete manualmente a la sección de "Bases de datos" para otorgar todos los privilegios (ALL PRIVILEGES) al nuevo usuario sobre la base de datos facturascripts_db.
     • Haga clic en "Ejecutar" en la parte inferior de la página.

3. Registrar la información de la base de datos: Anote lo siguiente de la base de datos que creó:

   • Nombre de la base de datos (facturascripts_db)
   • Nombre de usuario de la base de datos (facturascripts_user)
   • Contraseña del usuario de la base de datos (la contraseña que estableció)
   • Host de la base de datos (normalmente localhost o 127.0.0.1)
   • Puerto de la base de datos (por defecto MySQL es 3306, puede confirmarlo en la lista de servicios de ServBay)

Esta información será utilizada durante el proceso de instalación de FacturaScripts.

Configuración del servidor web (basado en Apache)

Ahora necesitamos indicarle a ServBay cómo servir nuestro proyecto de FacturaScripts a través de Apache.

1. Asegúrese de que el servicio Apache esté en ejecución:

   • En la interfaz de "Servicios" de ServBay, asegúrese de que el servicio Apache esté iniciado.

2. Agregar un host:

   • En el menú de la izquierda de ServBay, seleccione "Sitios".
   • Haga clic en el botón "+" a la derecha.
   • En la ventana de configuración emergente, complete la siguiente información:
     • Nombre: Asigne un nombre descriptivo a esta configuración de host, por ejemplo, FacturaScripts Demo.
     • Dominio: Ingrese el dominio que desea utilizar para acceder al sitio local de FacturaScripts. Para este propósito, usamos facturascripts.demo.
     • Tipo de sitio web: Seleccione PHP, indicando que este es un sitio web dinámico en PHP.
     • Directorio raíz: Haga clic en "Navegar" o "Seleccionar" y navegue hasta el directorio donde descomprimió los archivos de FacturaScripts (/Applications/ServBay/www/facturascripts_project).
     • Servidor web: Seleccione Apache y la versión de Apache que desea utilizar.
     • Versión de PHP: Seleccione una versión de PHP que sea compatible con la versión de FacturaScripts que descargó (consulte los requisitos del sistema de FacturaScripts, generalmente se recomiendan versiones estables más recientes como PHP 8.1 o 8.2).
     • Otras configuraciones: Generalmente mantenga los valores predeterminados, a menos que tenga necesidades especiales.

3. Guardar la configuración:

   • Haga clic en el botón "Agregar".
   • ServBay configurará automáticamente el host virtual de Apache y puede solicitarle permisos de administrador para modificar el archivo hosts del sistema, a fin de que facturascripts.demo apunte a la dirección IP local (127.0.0.1). Acepte esta operación.

4. Verificar extensiones de PHP:

   • FacturaScripts puede requerir extensiones específicas de PHP para funcionar correctamente (como pdo_mysql, gd, intl, zip, etc.).
   • En ServBay, puede gestionar las extensiones de PHP instaladas. Normalmente, las extensiones que se instalan por defecto en ServBay son suficientes, pero si se indica que falta alguna extensión durante la instalación, puede habilitarlas desde la sección de configuración de PHP de ServBay.

Acceder al sitio web

Ahora que todo está listo, puede comenzar el proceso de instalación en línea de FacturaScripts.

1. Abrir el navegador: Abra su navegador web preferido (como Chrome, Firefox, Safari).

2. Ingresar la dirección: En la barra de direcciones, ingrese https://facturascripts.demo y presione Enter.

3. Asistente de instalación de FacturaScripts:

   • Si todo está configurado correctamente, debería ver la interfaz de instalación de FacturaScripts.
   • Selección de idioma: Elija el idioma que desea utilizar.
   • Verificación del sistema: El instalador verificará si el entorno de su servidor (versión de PHP, extensiones requeridas, permisos de directorio, etc.) cumple con los requisitos. Si ServBay está configurado correctamente, deberían aparecer todos los elementos en verde. Si hay problemas, consulte las configuraciones de PHP o los permisos de archivo en ServBay siguiendo las indicaciones.
   • Configuración de la base de datos: Este es un paso crucial. Necesita ingresar la información de la base de datos que creó y registró previamente:
     • Tipo de base de datos: Seleccione MySQL.
     • Host: localhost o 127.0.0.1.
     • Puerto: 3306 (o el puerto de MySQL que vio en ServBay).
     • Nombre de la base de datos: facturascripts_db.
     • Nombre de usuario: facturascripts_user.
     • Contraseña: La contraseña que estableció para facturascripts_user.
     • Prefijo de las tablas: Puede dejar el valor predeterminado fs_.
   • Cuenta de administrador: Configure el nombre de usuario, la contraseña y el correo electrónico del administrador de FacturaScripts. Asegúrese de recordar esta información, ya que la necesitará para iniciar sesión en el backend.
   • Instalación: Haga clic en el botón de instalación; FacturaScripts creará las tablas de la base de datos y escribirá el archivo de configuración.

4. Finalización de la instalación:

   • Una vez completada la instalación, normalmente se le pedirá que elimine el directorio install (si existe, y si se le solicita, por razones de seguridad).
   • Ahora debería poder acceder a la página de inicio de sesión de FacturaScripts mediante http://facturascripts.demo. Inicie sesión con la cuenta de administrador que acaba de configurar y comience a explorar y usar FacturaScripts.

---

¡Felicidades! Ha creado y ejecutado con éxito un proyecto de FacturaScripts en un entorno local de macOS utilizando ServBay. ServBay simplifica la configuración y gestión del entorno del servidor local, permitiéndole enfocarse más en el desarrollo y uso de FacturaScripts en sí.