Inicio rápido

Este documento trata solo un tema: los pasos necesarios para convertir X1 de un paquete descargado en un sitio web accesible. Cada paso se mantiene lo más breve posible; los detalles de instalación no se explican aquí, consulte los enlaces cuando los necesite.

Flujo general

1. Descargue el paquete de publicación y verifíquelo.
2. Súbalo al servidor, configure la raíz del sitio y los permisos de directorio.
3. Abra el sitio en el navegador y cree el primer administrador.
4. Complete la información del sitio.
5. Publique su primera página.

X1 es un programa de sitio gratuito y con código fuente disponible, versión actual X1.0.0-beta.4. No tiene un asistente de instalación paso a paso; la base de datos se crea automáticamente en la primera visita, por lo que el proceso es más corto que con un CMS tradicional.

Paso 1: Descarga y verificación

Después de obtener el paquete de publicación desde los canales oficiales, confirme que los archivos estén íntegros antes de subirlos. El directorio del paquete de publicación es el programa en sí, y la raíz del sitio es public/.

• Compruebe el valor de verificación proporcionado con el paquete de publicación para confirmar que la descarga no está dañada.
• Tras descomprimir, revise la estructura de directorios: public/, app/ y data/ deben estar presentes.
• Si el paquete de publicación ya incluye vendor/, puede omitir la instalación de dependencias.

Para los requisitos de entorno, extensiones de PHP, configuración de nginx y cron, consulte Requisitos de entorno e instalación y despliegue.

Paso 2: Carga y permisos de directorio

Coloque en el servidor y apunte la raíz del sitio solo a public/. app/ y data/ deben ubicarse fuera de la raíz del sitio y no deben ser accesibles directamente desde el navegador.

• data/ debe ser escribible por el usuario que ejecuta el sitio web; la base de datos, app.key, la caché y los archivos subidos se almacenan aquí.
• En la primera visita, el programa crea automáticamente data/app.key y lo establece en 0600. No elimine ni reemplace este archivo.
• El límite de carga de PHP y client_max_body_size de nginx deben coincidir o este último debe ser mayor; de lo contrario, las imágenes grandes se rechazarán antes de llegar al programa.

Para los comandos específicos y ejemplos de nginx, consulte Requisitos de entorno e instalación y despliegue.

Paso 3: Primera visita y creación del administrador

Simplemente abra la dirección del sitio en el navegador. Si la base de datos no existe, el programa crea automáticamente la base de datos, las tablas, escribe la configuración predeterminada y genera app.key; no es necesario importar SQL manualmente.

Si aún no se ha creado un administrador, al visitar cualquier página se redirige a /admin/setup. En esta página de configuración única, complete:

Tras la creación exitosa, el navegador actual inicia sesión automáticamente y entra en la página de inicio del panel de administración /admin; /admin/setup devuelve permanentemente 404 y ya no se puede usar para crear un segundo administrador.

El nombre del sitio no se completa en esta página. Después de crear el administrador, vaya a «Configuración → Básico del sitio → Información básica» para modificarlo. Para instrucciones completas, consulte Primera visita y cuenta de administrador.

Paso 4: Complete la información del sitio web

Inicie sesión en el panel de administración, haga clic en «Configuración» en el menú izquierdo, vaya a «Básico del sitio → Información básica» y cambie el nombre del sitio, la información de contacto y otros datos por los de su empresa. El nombre del sitio predeterminado es «KingCMS»; debe cambiarlo en este paso.

• El icono «?» junto a los campos de configuración es una entrada de ayuda; pase el cursor sobre él para ver la descripción del campo.
• La interfaz del panel de administración está en chino; las columnas de configuración y los nombres de menú están en chino.
• Antes de la puesta en producción, debe configurar HTTPS; las devoluciones de llamada de WeChat y Alipay y las cookies Secure dependen de HTTPS.

Para conocer la finalidad de cada configuración, consulte Configuración de parámetros.

Paso 5: Publique su primera página

El contenido se organiza creando categorías en «Configuración del sistema → Categorías» y luego escribiendo artículos en «Contenido → Artículos». Cree primero una categoría y luego escriba artículos dentro de ella; las páginas serán accesibles en el frontend.

1. Haga clic en «Configuración del sistema → Categorías» en el menú izquierdo y cree una nueva categoría, por ejemplo «Sobre nosotros».
2. Haga clic en «Contenido → Artículos» en el menú izquierdo y cree un nuevo artículo dentro de esa categoría, completando el título y el cuerpo.
3. Después de guardar, ábralo en el frontend para confirmar que se muestra correctamente.

Para las descripciones de los campos de categorías y artículos, consulte Categorías y Artículos.

Comprobaciones rápidas antes de la puesta en línea

• Puede usar «Cambiar contraseña» en la esquina superior derecha del panel de administración; la nueva contraseña debe tener al menos 8 caracteres.
• Si olvida la contraseña del administrador, restablézcala con php bin/kingcms admin:reset-password; esto no borrará categorías, artículos, productos ni configuraciones.
• Configure cron para que los hooks por minuto de los módulos habilitados y las tareas programadas del panel de administración se ejecuten correctamente; consulte Requisitos de entorno e instalación y despliegue.
• Para copias de seguridad, consulte Copia de seguridad; para actualizaciones, consulte Actualización.

En este punto, el sitio web ya es accesible, puede iniciar sesión en el panel de administración y publicar contenido. Después, habilite módulos, ajuste temas y configure opciones según las necesidades de su negocio.