Existen dos modalidades de instalar el proyecto. Una Manual y otra por medio de Vagrant (método preferido).

Instalaciòn manual.

Prerequisitos:

GIT
PHP
MySql

Descargar e instalar composer. Composer es una herramienta para gestionar dependencias en PHP. Para instalar Composer en Windows, debemos descargarlo de su página oficial [Composer] y en la sección Windows Installer descargar Composer-Setup.exe.
Instalar laravel. Una vez instalado el composer, vamos a la lìnea de comandos y ejecutar
```
$ composer global require "laravel/installer"
```
Clonar el repositorio del sitio. 3.a Crear el directorio que contendrá el còdigo fuente del sitio web. 3.b Ir a la lìnea de comandos y nos posicinamos dentro del directorio apenas creado. 3.c Descargamos el còdigo fuente del sitio web
```
$ git clone https://github.com/harregoces/MicroSitio.git .
```
Instalar las librerìas. En la linea de comando acceder al directorio creado en el punto 3. y ejecutar
```
$ cd sitio
$ composer install
```

Configurar las credenciales de acceso al data base. 5.a Editar el archivo

sitio/config/database.php

y en la secciòn mysql, si es necesario, modificar las propiedades username y password con los valores correctos para acceder al database

'mysql' => [
        'driver' => 'mysql',
        'host' => env('DB_HOST', '127.0.0.1'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'micrositio'),
        'username' => env('DB_USERNAME', 'root'),
        'password' => env('DB_PASSWORD', 'xxxxxxxx'),
        ...
    ],

5.b. Editar el archivo

sitio/.env

Verificar las propiedades database, username y password contengan los valores correctos para crear la conexiòn con el database.

DB_DATABASE=micrositio
DB_USERNAME=root
DB_PASSWORD=xxxxxxxx

Crear las tablas. Desde la linea de comandos, en la raìz del directorio del sitio web, ejecutar el comando.
```
$ php artisan migrate
```
Redireccionar el host. Editar el archivo hosts y agregar la siguiente linea.
```
127.0.0.1       micrositio.com
```
En windows, el archivo hosts generalmente se encuentra en Windows\System32\Drivers\etc\hosts mientras que en sistemas linux se encuentra en /etc/hosts

Configurar el virtual VHOST Agregar el virtual host al web server utilizado. Si se usa Apache, il virtual host deberìa ser como el siguiente:

<VirtualHost *:80>
DocumentRoot "MicroSitio\sitio"
<Directory "MicroSitio\sitio">
    Options +Indexes +FollowSymLinks
    DirectoryIndex index.php
    Order allow,deny
    Allow from all
    AllowOverride All
</Directory>

ServerName micrositio.com:80

</VirtualHost>

Si se usa nginx:

server {
    listen 80;

    server_name micrositio.com;

    root /shared/development/code;
    index  index.php index.html index.htm;

    location / {
            proxy_http_version 1.1;
            proxy_set_header Upgrade $http_upgrade;
            proxy_set_header Connection keep-alive;
            proxy_set_header Host $host;
            proxy_cache_bypass $http_upgrade;
           try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
            try_files $uri =404;
            fastcgi_split_path_info ^(.+\.php)(/.+)$;
            fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
            fastcgi_index index.php;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
            include fastcgi_params;
    }
}

reiniciar el web server luego de haber agregado el virtual host

Verificar la instalaciòn. Para verificar la instalaciòn del sitio web, navegar a la siguiente direcciòn en el browser de preferencia http://micrositio.com/merchantid/{merchantid} http://micrositio.com/merchantid/172

Instalaciòn utilizando Vagrant.

Vagrant es una herramienta para desarrolladores que facilita la creación de entornos virtuales para desarrollo. En Vagrant podemos instalar y configurar software dentro de una máquina virtual para asì simular en el servidor en el que se alojará la aplicación Web.

Prerequisitos:

Còdigo fuente del sitio previamente clonado

$ git clone https://github.com/harregoces/MicroSitio.git .

Descargar e instalar la ùltima versiòn de VirtualBox. Asegúrese de descargar el instalador o paquete adecuado para su plataforma. Instale el paquete usando el procedimiento estàndard de su sistema operativo manteniendo las opciones de configuraciòn predeterminadas 1.a Si se instala en Windows, hacer doble clic en el archivo de instalación y seguir las instrucciones. 1.b Si se instala en una Mac, abrir el archivo DMG y arrastrarlo hacia tu carpeta de aplicaciones.
Descargar e instalar la ùltima versiòn de Vagrant. Asegúrese de descargar el instalador o paquete adecuado para su plataforma. Instale el paquete usando el procedimiento estàndard de su sistema operativo manteniendo las opciones de configuraciòn predeterminadas 1.a Si se instala en Windows, hacer doble clic en el archivo de instalación y seguir las instrucciones. 1.b Si se instala en una Mac, abrir el archivo DMG y arrastrarlo hacia tu carpeta de aplicaciones.

Configuraciòn

Create y configurar la màquina virtual sobre la que se ejecutarà el sitio web: 1.a. Posicionarse en el directorio raìz del còdigo fuente. 1.b. ingresar al directorio Vagrant
```
$ cd vagrant
```
1.c. Iniciar la màquina virtual
```
$ vagrant up
```
La primera vez que se ejecuta este comando, se crea la màquina virtual linux sobre la que se ejecutarà el sitio web e instalarà todos los programas y dependencias que el sitio requiere (PHP7, Composer, mysql, etc). Luego la ejecuciòn de este comando sòlo iniciarà la màquina virtual, es decir iniciarà el servidor host de la aplicaciòn.

Para detener la ejecuciòn de la màquina virtual se usa el comando.
```
$ vagrant halt
```
Redireccionar el host. Editar el archivo hosts y agregar la siguiente linea.
```
192.168.39.103       micrositio.com
```
En windows, el archivo hosts generalmente se encuentra en Windows\System32\Drivers\etc\hosts mientras que en sistemas linux se encuentra en /etc/hosts
Verificar la instalaciòn. Para verificar la instalaciòn del sitio web, navegar a la siguiente direcciòn en el browser de preferencia http://micrositio.com/merchantid/{merchantid} Ejemplo: http://micrositio.com/merchantid/172
Para leer los datos del google tag manager account se usa la url http://micrositio.com/getmerchantaccountbyid/{merchantid} Ejemplo: http://micrositio.com/getmerchantaccountbyid/172

Si GTM está instalado, se retorna un JSON como el siguiente:

{ "code": "INSTALLED", "container": { "id": 5, "idcliente": 202, "gtm_code": "{"access_token":"ya29.Glv2BLnupQgGLzFF_UxZ_dkK3-d-g_srXjo3GzOP0ajCJw4J0i5sbSUYQ1oqpR1qvuozwc_xruuhjtk0o80GKe7_62wuazL4GlWHalNyNno4Czlsw9WrY3SjUWrJ","token_type":"Bearer","expires_in":3600,"refresh_token":"1\/tBMZwfL0mmGUjd308Vmi9UTkKG4yLpT18gDK59Ujm6NhSMY8bZPXCjFtzBXDjqPm","created":1509519539}", "ga_code": ""{\"access_token\":\"ya29.Glv2BBA35fVUBBKgbcYx2nT7u1hIiL2go0D37XDVozsjWFrihWiZJsWkA0X41_N687GkQgSWfiufcAywKG9u5EF9citOLnpC-9F692yZbTdnBtMlNhliV-2CDAEl\",\"token_type\":\"Bearer\",\"expires_in\":3600,\"refresh_token\":\"1\\\/2blSk1eGCSD_XH8O7VzsYWOo4dxiBJ8suodMAYNXdeU\",\"created\":1509519559}"", "gtmaccount": "{"containerId":"7728507","containerName":"nutmeg.com","containerPath":"accounts\/1607827098\/containers\/7728507","publicId":"GTM-TDNHJSS","accountId":"1607827098"}", "workspaceid": "accounts/1607827098/containers/7728507/workspaces/8", "ga_account": "86175990", "ga_property": "UA-86175990-1", "ga_view": "132136873", "uat_id": "14", "created_at": null, "updated_at": null } }

En caso de que Google Analytics esté instalado, dentro del JSON se puede leer la cuenta de Analytics instalada, dentro de la propiedad ga_property.

Si GTM no está instalado, el servicio devolverá el siguiente JSON:

{"code":"NOT_INSTALLED","container":null}

Para acceder a todas las gráficas disponibles, las url deben ser de la siguiente manera: http://micrositio.com/dashboard/merchantid/{merchantid}/ Ejemplo: http://micrositio.com/dashboard/merchantid/200/
Para acceder a un gráfico en particular, para por ejemplo embeberlo como iframe, se puede acceder a través del siguiente link

http://micrositio.com/dashboard/merchantid/{merchantid}/type/{tipo_grafico} Ejemplo: http://micrositio.com/dashboard/merchantid/200/type/sessionspie

Los tipos de gráficos disponibles son:

sessionspie
sessionspercountrypie
sessionsperbrowser
thisweeklastweekbysessions
activeusers
thisyearlastyearbyusers
topbrowsersbypageviewpie
topcountriesbysessionspie
randomcharts

En la siguiente URL es posible ver un ejemplo de gráficos embebidos en iframes:

http://micrositio.com/dashboardiframes/merchantid/200

Si se requiere redireccionar el usuario directamente a los workflows de OAuth2 de GTM, se puede redireccionar a través de la siguiente URL:

http://micrositio.com/installplugingtm/merchantid/{merchantid}/?returnurl={returnurl} Ejemplo: http://micrositio.com/installplugingtm/merchantid/200/?returnurl=http%3A%2F%2Fmicrositio.com%2Fmerchantid%2F202%2F%3Freturned

Una vez instalado GTM, Si se requiere redireccionar el usuario directamente a los workflows de OAuth2 de Google Analytics, se puede redireccionar a través de la siguiente URL:

http://micrositio.com/installpluginga/merchantid/{merchantid}/?returnurl={returnurl} Ejemplo: http://micrositio.com/installpluginga/merchantid/200/?returnurl=http%3A%2F%2Fmicrositio.com%2Fmerchantid%2F202%2F%3Freturned

Para desinstalar GTM y GA es posible acceder directamente al siguiente link http://micrositio.com/uninstall/merchantid/{merchantid}/ Ejemplo: http://micrositio.com/uninstall/merchantid/202/

harregoces / MicroSitio

Instalaciòn manual.

Prerequisitos:

Instalaciòn utilizando Vagrant.

Prerequisitos:

Configuraciòn

About

Languages