Esta guía te acompaña en la instalación de Zittme. Hay dos tipos de entorno principales.

• Hosting web: te registras con un proveedor de hosting. La base de datos y el servidor web ya están listos, así que solo tienes que subir los archivos.
• Servidor propio (VPS): administras el servidor tú mismo. Preparas el servidor web y la base de datos por tu cuenta.

Sigue solo la parte que corresponda a tu entorno. A partir del asistente de instalación, los dos entornos son iguales.

Requisitos de instalación

La mayoría de los planes de hosting PHP de proveedores coreanos (Cafe24, Dothome, Gabia, etc.) cumplen estos requisitos. Si al registrarte puedes elegir la versión de PHP, elige 8.2 o superior. De todos modos, el paso de verificación del entorno del asistente de instalación te señala lo que falte.

Descargar el paquete de distribución (común)

Descarga el paquete más reciente desde la página de versiones de zitt.me. Durante el periodo beta actual, solo pueden descargarlo los miembros registrados como testers.

---

A. Instalar en un hosting web

A-1. Revisar los datos de la base de datos

En el hosting web, la base de datos se crea al registrarte. Revisa estos valores en el panel de administración del hosting (Administrar mis servicios, etc.). Los ingresarás tal cual en el asistente de instalación.

• Host de la base de datos (normalmente localhost)
• Nombre de la base de datos
• Usuario de la base de datos
• Contraseña de la base de datos (la que definiste al registrarte)

A-2. Subir los archivos

Descomprime primero en tu computadora el paquete descargado y súbelo a la raíz web del hosting con un programa FTP (FileZilla, etc.). El nombre de la carpeta raíz web varía según el proveedor (www, public_html, html, etc.).

• Son decenas de miles de archivos, así que la subida por FTP tarda, y los programas FTP a veces omiten algunos archivos al subir miles de ellos. Si el proveedor ofrece una función para descomprimir (administrador de archivos web), es más rápido y seguro subir el tgz/zip y descomprimirlo en el servidor.
• Después de subirlo, verifica que index.php esté directamente en la raíz web. Si quedó un nivel más adentro, como zittme/index.php, debes mover el contenido de esa carpeta a la raíz web. En ese caso, mueve también los archivos ocultos como .htaccess.
• Crea una carpeta files en la raíz web y ponle permisos 707 (o 777) desde el administrador de archivos. Todas las subidas y la caché del sitio se guardan en esta carpeta.

A-3. Acceder

Al entrar con el navegador a tu dominio (o a la dirección temporal que te dio el hosting), se inicia el asistente de instalación. Pasa a la sección "Asistente de instalación" más abajo.

La mayoría de los hostings web usan Apache, así que el .htaccess incluido en el paquete maneja automáticamente las direcciones cortas. No necesitas configurar nada más.

---

B. Instalar en un servidor propio (VPS)

Se asume un servidor con acceso por shell (SSH).

B-1. Subir los archivos

tar xzf zittme-0.0.01.tgz -C /var/www/mysite
mkdir -p /var/www/mysite/files
chown -R www-data:www-data /var/www/mysite

La cuenta del servidor web (www-data en el ejemplo) debe poder escribir en la carpeta files para que la instalación avance. Todas las subidas, la caché y la configuración del sitio se guardan en esta carpeta.

B-2. Crear la base de datos

CREATE DATABASE mysite DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'mysite'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON mysite.* TO 'mysite'@'localhost';
FLUSH PRIVILEGES;

B-3. Configurar el servidor web (nginx)

Zittme ofrece ayudas para configurar nginx.

• Pantalla de verificación del entorno del asistente de instalación: detecta el entorno del servidor y genera una configuración a la medida junto con los comandos para aplicarla.
• common/scripts/setup-nginx.sh del paquete: un script que lo aplica todo de una vez.
• Ejemplo de configuración: common/manual/server_config/zittme-nginx.conf

Si usas Apache, el .htaccess del paquete se encarga, así que solo necesitas tener activado mod_rewrite.

---

Asistente de instalación (común)

Al entrar con el navegador a la dirección del sitio, se inicia el asistente de instalación. Avanza siguiendo los pasos que se muestran en la parte superior de la pantalla.

• Verificación del entorno: revisa automáticamente si el servidor cumple los requisitos. Si hay algún problema, verás indicaciones para cada elemento.
• Aceptación de la licencia: Zittme es software libre bajo GPL v2.
• Datos de la base de datos: en hosting web, ingresa los valores que revisaste en A-1; en servidor propio, los que creaste en B-2.
• Creación de la cuenta de administrador: define el correo y la contraseña del administrador principal del sitio.

Al terminar la instalación, el sitio se abre con los menús predeterminados (Inicio, Tablero) y el editor predeterminado queda configurado como zittEditor.

Qué revisar justo después de instalar

• Acceso a la administración: your-site/admin
• Configuración del sistema > Configuración básica: título del sitio, idioma predeterminado, zona horaria
• Ajustes del panel de administración: posición del menú de administración (arriba, izquierda, derecha), registro del logo de administración
• Verificar la subida de archivos: escribe una publicación en un tablero y adjunta una imagen. Si falla, revisa los permisos de escritura de la carpeta files/. En hosting web puedes ajustar los permisos a 707 o 755 desde el administrador de archivos.

Actualizaciones

Cuando aparezca el aviso de una nueva versión en el panel de administración, descarga el nuevo paquete desde la página de versiones y sobrescribe los archivos. Después de sobrescribir, al entrar a la administración se aplican automáticamente los cambios necesarios en la base de datos. Antes de actualizar, respalda siempre files/ y la base de datos.