============================================================
G&S GOLD TRAVEL - PaginaWeb4.0
MANUAL DE INSTALACION
============================================================

IMPORTANTE
Este manual corresponde a la instalacion de desarrollo de
PaginaWeb4.0.

La base de datos debe comenzar completamente vacia.

------------------------------------------------------------
1. CREAR LA BASE DE DATOS
------------------------------------------------------------

En XAMPP:

1. Abrir phpMyAdmin.
2. Crear una base de datos nueva.

Ejemplo:

    gs_goldtravel_web4

Seleccionar el cotejamiento:

    utf8mb4_unicode_ci

No crear ninguna tabla manualmente.

------------------------------------------------------------
2. EJECUTAR LOS SCRIPTS SQL
------------------------------------------------------------

Dentro de:

    PaginaWeb4.0/sql/

ejecutar los archivos EXACTAMENTE en este orden:

    001_Usuarios.sql
    002_Seguridad.sql
    003_Contacto.sql
    004_PaletaColores.sql
    005_Tipografias.sql
    006_Paginas.sql
    007_Cabecera.sql
    008_Menu.sql
    009_Pie.sql
    010_Constructor.sql
    011_Relaciones.sql

No ejecutar ningun otro archivo SQL.

------------------------------------------------------------
3. DATOS INICIALES
------------------------------------------------------------

Los scripts crean solamente la estructura de la base de datos.

NO se cargan automaticamente:

    - usuarios
    - colores
    - tipografias
    - paginas
    - menu
    - submenus
    - contenido
    - configuracion personalizada del pie

Todo eso se configurara posteriormente desde el editor.

------------------------------------------------------------
4. COLOCAR EL PROYECTO EN XAMPP
------------------------------------------------------------

Copiar la carpeta:

    PaginaWeb4.0

a:

    C:\xampp\htdocs\

Debe quedar:

    C:\xampp\htdocs\PaginaWeb4.0

------------------------------------------------------------
5. CONFIGURAR LA CONEXION
------------------------------------------------------------

Editar:

    config/database.php

En XAMPP normalmente:

    Servidor: localhost
    Usuario: root
    Contraseña: vacia
    Base de datos: gs_goldtravel_web4

Si tu instalacion de MySQL utiliza otra contraseña,
colocar la contraseña correspondiente.

------------------------------------------------------------
6. CREAR EL PRIMER ADMINISTRADOR
------------------------------------------------------------

Abrir:

    http://localhost/PaginaWeb4.0/gs-admin/instalar/

Si el instalador solicita una clave, utilizar la clave
configurada en:

    config/instalacion.php

Completar:

    Nombre
    Usuario
    Contraseña
    Confirmar contraseña

Pulsar:

    CREAR ADMINISTRADOR

La contraseña se almacena mediante:

    password_hash()

Nunca se debe guardar la contraseña manualmente en MySQL.

------------------------------------------------------------
7. ENTRAR AL EDITOR
------------------------------------------------------------

Despues de crear el administrador:

    http://localhost/PaginaWeb4.0/gs-admin/

Utilizar el usuario y la contraseña creados.

------------------------------------------------------------
8. INSTALACION EN UNA NUEVA BASE
------------------------------------------------------------

Cada vez que necesitemos una instalacion completamente nueva:

    1. Crear una BD nueva.
    2. Seleccionarla.
    3. Ejecutar 001 hasta 011 en orden.
    4. Configurar database.php.
    5. Crear el primer administrador.
    6. Configurar la web desde el editor.

No reutilizar tablas de una BD anterior.

------------------------------------------------------------
9. CPANEL
------------------------------------------------------------

Cuando el proyecto termine:

    1. Crear la BD desde cPanel.
    2. Crear/asignar el usuario MySQL.
    3. Abrir phpMyAdmin de cPanel.
    4. Seleccionar la BD creada por cPanel.
    5. Ejecutar los mismos scripts 001 a 011 en orden.
    6. Configurar database.php con las credenciales de cPanel.
    7. Crear el primer administrador.
    8. Configurar el sitio desde el editor.

El nombre de la BD puede ser diferente al utilizado en XAMPP.

Los scripts NO dependen de un nombre especifico de base de datos.

------------------------------------------------------------
10. REGLA PARA LOS CAMBIOS FUTUROS
------------------------------------------------------------

Una vez entregado un script SQL, no se debe modificar
silenciosamente para solucionar cambios posteriores.

Si una tabla necesita una modificacion durante el desarrollo,
se creara posteriormente un nuevo script numerado/migracion.

Esto permite saber exactamente que cambios se hicieron en
cada version de la base de datos.

============================================================
FIN DEL MANUAL
============================================================
