Instalación y Configuración de OctoberCMS en el Entorno de ServBay

¿Qué es OctoberCMS?

OctoberCMS es un sistema de gestión de contenido (CMS) de código abierto basado en el framework Laravel. Ofrece poderosas funcionalidades y una flexibilidad de expansión adecuada para construir diversos tipos de sitios web. OctoberCMS es conocido por su interfaz de usuario sencilla y sus características amigables para desarrolladores.

Pasos para Instalar OctoberCMS

En este artículo, presentaremos cómo instalar y configurar OctoberCMS en el entorno de ServBay.

Paso 1: Crear el Directorio del Proyecto

Primero, crea un nuevo directorio de proyecto en el directorio www de ServBay:

cd /Applications/ServBay/www
mkdir servbay-octobercms-app
cd servbay-octobercms-app

Paso 2: Instalar OctoberCMS con Composer

ServBay ya incluye Composer, por lo que podemos usar Composer directamente para instalar OctoberCMS:

composer create-project october/october .

Paso 3: Crear la Base de Datos y el Usuario

1. Acceder a la herramienta de gestión de base de datos phpMyAdmin incluida en ServBay

   Abre https://servbay.host/, haz clic en "phpMyAdmin" para acceder a la herramienta de gestión de bases de datos phpMyAdmin.

2. Crear el usuario de la base de datos

   1. Acceder a la página de cuentas de usuario

      • En la página principal de phpMyAdmin, haz clic en "Cuentas de usuario" en el menú superior.

   2. Agregar nuevo usuario

      • Haz clic en "Agregar cuenta de usuario".
      • Completa la siguiente información:
        • Nombre de usuario: october_user
        • Nombre de host: localhost
        • Contraseña: ingresa una contraseña segura, por ejemplo, password123
        • Vuelve a ingresar la contraseña
      • En la sección "Crear base de datos para el usuario", selecciona "Crear una base de datos con el mismo nombre y otorgar todos los permisos".
      • Asegúrate de marcar "Conceder todos los privilegios".
      • Haz clic en el botón "Continuar".

Paso 4: Configurar el Servidor Web

1. Agregar un nuevo sitio web

   Abre ServBay, haz clic en la pestaña "Hosts" y agrega un nuevo sitio web:

   • Nombre: Mi Sitio OctoberCMS
   • Dominio: servbay-octobercms.local
   • Tipo de Sitio: PHP
   • Versión de PHP: selecciona la versión de PHP correspondiente
   • Directorio raíz del sitio: /Applications/ServBay/www/servbay-octobercms-app

2. Guardar configuración

   Guarda la configuración y reinicia ServBay.

Paso 5: Configurar OctoberCMS

1. Editar el archivo de configuración del entorno

   En el directorio raíz del proyecto, copia el archivo .env.example como .env:

   cp .env.example .env

2. Editar el archivo .env

   Abre el archivo .env con un editor de texto y configura la información de conexión a la base de datos y otras configuraciones necesarias:

   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user
   DB_USERNAME=october_user
   DB_PASSWORD=password123

Paso 6: Ejecutar el Instalador de OctoberCMS

1. Acceder a la página de instalación

   Abre el navegador y visita https://servbay-octobercms.local/install.php. Verás la página de instalación de OctoberCMS.

2. Completar la información de la base de datos

   Sigue las indicaciones de la página para completar la información de conexión de la base de datos:

   • Tipo de base de datos: MySQL
   • Host de la base de datos: localhost
   • Nombre de la base de datos: october_user (el mismo que el nombre de usuario)
   • Nombre de usuario de la base de datos: october_user
   • Contraseña de la base de datos: password123

3. Completar la información del administrador

   Sigue las indicaciones de la página para completar el nombre de usuario y contraseña del administrador, entre otros detalles.

4. Completar la instalación

   Haz clic en el botón "Instalar" para completar el proceso de instalación.

Paso 7: Instalar Plugins y Temas

1. Instalar plugins

   Inicia sesión en el panel de administración de OctoberCMS, haz clic en "Plugins", busca e instala los plugins que necesites.

2. Instalar temas

   Haz clic en "Apariencia" -> "Temas", selecciona e instala un tema de tu elección.

Usar OctoberCMS para Construir Sitios Web

Ahora has instalado y configurado con éxito OctoberCMS en el entorno de ServBay y puedes empezar a usarlo para construir tu sitio web. A continuación, se muestran algunas operaciones comunes:

Crear Páginas y Contenido

1. Crear páginas

   En el panel de administración de OctoberCMS, haz clic en "CMS" -> "Páginas", crea una nueva página, completa el título y contenido de la página, luego haz clic en "Guardar".

2. Crear bloques de contenido

   Haz clic en "CMS" -> "Contenido", crea un nuevo bloque de contenido, completa el título del contenido y su contenido, luego haz clic en "Guardar".

Configurar el Menú de Navegación

1. Crear un menú

   En el panel de administración de OctoberCMS, haz clic en "CMS" -> "Parcial", crea un nuevo parcial para el menú de navegación.

2. Agregar elementos al menú

   Agrega las páginas y bloques de contenido al menú de navegación, luego haz clic en "Guardar".

Personalizar Widgets

1. Agregar widgets

   En el panel de administración de OctoberCMS, haz clic en "CMS" -> "Parcial", crea un nuevo parcial para los widgets.

2. Configurar widgets

   Configura los ajustes del widget según sea necesario, luego haz clic en "Guardar".

Con estos pasos, has instalado y configurado con éxito OctoberCMS en el entorno de ServBay y has comenzado a usarlo para construir tu sitio web. Las poderosas características y la flexibilidad de OctoberCMS lo convierten en una elección ideal para construir diversos tipos de sitios web.