Recent changes to wiki

WikiPage Clientes API modified by Víctor Puertas

Víctor Puertas — Tue, 08 May 2012 17:52:51 -0000

--- v1 
+++ v2 
@@ -4,4 +4,4 @@
 
 ##Python##
 
-* [Vavag Cliente](https://github.com/GeoRemindMe/vavagClient/tree/a373deb8f7cdecd297edff37b0042f8651f08b77) by jneight. Licencia [GPL v3](http://www.gnu.org/licenses/gpl-3.0.html)
+* [Vavag Client](https://github.com/GeoRemindMe/vavagClient/tree/a373deb8f7cdecd297edff37b0042f8651f08b77) by [jneight](https://github.com/jneight). Licencia [GPL v3](http://www.gnu.org/licenses/gpl-3.0.html)

WikiPage Clientes API modified by Víctor Puertas

Víctor Puertas — Tue, 08 May 2012 17:51:31 -0000

#Clientes API# Clientes de acceso a la API de Vavag. ##Python## * [Vavag Cliente](https://github.com/GeoRemindMe/vavagClient/tree/a373deb8f7cdecd297edff37b0042f8651f08b77) by jneight. Licencia [GPL v3](http://www.gnu.org/licenses/gpl-3.0.html)

WikiPage home modified by Víctor Puertas

Víctor Puertas — Tue, 08 May 2012 17:46:43 -0000

--- v7 
+++ v8 
@@ -6,6 +6,9 @@
 
 [Instalación de Vavag en el servidor](https://sourceforge.net/p/vavag/wiki/Instalaci%C3%B3n%20de%20Vavag%20en%20el%20servidor/)
 
+# API #
+[Clientes API](https://sourceforge.net/p/vavag/wiki/Clientes%20API)
+
 # Recursos #
 
 * ** Blog de Vavag **: [blog.vavag.com](http://blog.vavag.com)

WikiPage Instalación de Vavag en el servidor modified by Víctor Puertas

Víctor Puertas — Mon, 07 May 2012 21:22:56 -0000

--- v4 
+++ v5 
@@ -81,4 +81,19 @@
 * ** vavag1.lan **: Dominio principal. Se asemeja a [vavag.com](http://vavag.com)
 * ** vavag2.lan **: Dominio para los enlaces cortos. Se asemeja a [v3g.es](http://v3g.es)
 
-Todos los enlaces cortos se generan con vavag2.lan. Este dominio se puede configurar en base de datos dentro de la tabla: ** dominio_acortador **.
+Si no queremos montar un [servidor DNS]() en el entorno de desarrollo, podemos simularlo editando el fichero de hosts del sistema operativo:
+
+> nano /etc/hosts
+
+que quedaría como sigue:
+
+> 192.168.0.131   vavag1.lan
+> 192.168.0.131   vavag2.lan
+
+Cada usuario de Vavag puede tener un dominio propio con el que generar los enlaces cortos. Existe un dominio por defecto para los usuarios que no tienen dominio corto personalizado.
+
+El dominio acortador por defecto se define la propiedad de configuración: **dominioAcortadorIdDefecto** dentro del fichero:
+
+> /apps/frontend/config/**app.yml**
+
+Esta clave contiene el Id del dominio acortador por defecto.

WikiPage home modified by Víctor Puertas

Víctor Puertas — Mon, 07 May 2012 20:58:01 -0000

--- v6 
+++ v7 
@@ -1,10 +1,10 @@
 # Documentación (ES) de Vavag #
 
-Esta wiki tiene el objetivo de compartir documentación sobre la instalación y código fuente de [Vavag](http://vavag.com), hacer guías de usuario, preguntas frecuentes (FAQs) dejar enlaces a clones o recursos útiles para Vavag, etc. Si quieres colaborar, recuerda leer las [Reglas de uso].
-
+Esta wiki tiene el objetivo de compartir documentación sobre la instalación y código fuente de [Vavag](http://vavag.com), hacer guías de usuario, preguntas frecuentes (FAQs) dejar enlaces a clones o recursos útiles para Vavag, etc. Si quieres colaborar, recuerda leer las [Reglas de uso](https://sourceforge.net/p/vavag/wiki/Reglas%20de%20uso/).
+
 # Empezar #
 
-[Instalación de Vavag en el servidor]
+[Instalación de Vavag en el servidor](https://sourceforge.net/p/vavag/wiki/Instalaci%C3%B3n%20de%20Vavag%20en%20el%20servidor/)
 
 # Recursos #

WikiPage Instalación de Vavag en el servidor modified by Víctor Puertas

Víctor Puertas — Mon, 07 May 2012 13:24:50 -0000

WikiPage home modified by Víctor Puertas

Víctor Puertas — Sun, 06 May 2012 11:36:19 -0000

--- v5 
+++ v6 
@@ -8,4 +8,4 @@
 
 # Recursos #
 
-* ** Blog de Vavag **: (blog.vavag.com)[http://blog.vavag.com]
+* ** Blog de Vavag **: [blog.vavag.com](http://blog.vavag.com)

WikiPage Reglas de uso modified by Víctor Puertas

Víctor Puertas — Sun, 06 May 2012 11:35:24 -0000

# Reglas de uso para esta wiki # * Cualquier usuario de Vavag puede colaborar. * No utilizar insultos, ni insultar a nadie. No ser agresivo, ni destructivo. * No poner publicidad, ni enlaces a páginas personales o fuera de tema. * Firmar los comentarios o las sugerencias personales. * Escribir correctamente, utilizando acentos, signos de puntuación y minúsculas. NO USAR TODO MAYUSCULAS. * Si queréis comentar sobre algo, utilizad la parte de discusión de la página [discussion](https://sourceforge.net/p/vavag/discussion/). * Para aportar sugerencias, usar el ** [foro](https://sourceforge.net/p/vavag/discussion/sugerencias/) ** creado para tal fin.

WikiPage home modified by Víctor Puertas

Víctor Puertas — Sun, 06 May 2012 11:25:55 -0000

--- v4 
+++ v5 
@@ -1,18 +1,11 @@
 # Documentación (ES) de Vavag #
 
-Vavag es un servicio que permite crear colecciones de URLs, y distribuirlas fácilmente mediante una URL corta en redes sociales, páginas web, blogs o correo eletrónico. Es posible seguir el impacto en los usuarios que cada colección tiene mediante un detallado sistema de estadísticas.
-
-Vavag es más que un acortador de URLs tradicional. Las colecciones permiten compartir contenido relacionado como vídeo, archivos y páginas web en un solo enlace. 
-
-## Infraestructura ##
-* Vavag corre sobre una infraestrucura [LAMP](http://es.wikipedia.org/wiki/LAMP).
-* [PHP 5.2 o superior](www.php.net/)
-* [MySQL 5.1.54 o superior](http://www.mysql.com/)
-* Symfony Framework [1.4.17](http://www.symfony-project.org/installation/1_4 "Última revisión de la rama 1.4")
-
-## Sobre esta wiki ##
-
-Esta wiki tiene el objetivo de compartir documentación sobre la instalación y código fuente de [Vavag](http://vavag.com). Si quieres colaborar, recuerda que esta wiki usa sintaxis [Markdown](/p/vavag/wiki/markdown_syntax/).
-
-[[project_admins]]
-[[download_button]]
+Esta wiki tiene el objetivo de compartir documentación sobre la instalación y código fuente de [Vavag](http://vavag.com), hacer guías de usuario, preguntas frecuentes (FAQs) dejar enlaces a clones o recursos útiles para Vavag, etc. Si quieres colaborar, recuerda leer las [Reglas de uso].
+
+# Empezar #
+
+[Instalación de Vavag en el servidor]
+
+# Recursos #
+
+* ** Blog de Vavag **: (blog.vavag.com)[http://blog.vavag.com]

WikiPage Instalación de Vavag en el servidor modified by Víctor Puertas

Víctor Puertas — Sun, 06 May 2012 11:11:07 -0000

--- v2 
+++ v3 
@@ -4,15 +4,81 @@
 
 # Requisitos #
 
-* PHP 5.2 o superior
-* MySQL 5.1.54 o superior
+* [PHP](http://www.php,net) 5.2 o superior
+* [MySQL](http://mysql.com) 5.1.54 o superior
 * Servidor web: Apache o cualquier otro que soporte PHP
 
 # Obtención del código #
 
 Se puede obtener el código fuente del [repositorio GIT](https://sourceforge.net/p/vavag/code) o bien descargarlos en un fichero comprimido:
 
 [[download_button]]
 
 
-# Condiguración del acceso a MySQL #
+# Condiguración de los permisos de directorio #
+
+Una vez Vavag esté en un directorio visible para el servidor web (/var/www en Linux) es necesario dar permisos para el usuario que utiliza el servidor web, que en Ubuntu suele ser www-data. Necesitan **permiso de escritura los siguientes directorios y subdirectorios interiores**:
+
+* /cache
+* /web/uploads
+* /log
+
+Symfony incorpora proporciona un conjunto de comandos que facilitan las tareas de mantenimiento del proyecto. Todas ellas se encuentran en el fichero **symfony** y para poder ejecutarlos es necesario añadirle permisos de ejecución:
+
+> ** chmod +x symfony **
+
+# Modelo de datos #
+
+[PhpMyadmin](http://www.phpmyadmin.net) o cualquier otro cliente MySQL nos permitirá crear la estructura del modelo de datos usado por Vavag.
+
+## Estructura de datos ##
+
+Para instalar Vavag de forma rápida, crearemos una base de datos con la configuración siguiente:
+
+* Base de datos: ** vavag_db **
+* Usuario: ** vavagdb **
+* Password: ** vavagtest **
+
+Podemos configurar estos valores en el fichero **/config/databases.yml **
+
+Los script SQL que montan toda la estructura de tablas, índices y funciones se encuentran en ** /data/sql **:
+
+* ** lib.model.schema.sql **: Tablas e índices.
+* ** lib.model.functions.sql ** Funciones.
+* ** plugins.sfGoogleSafeBrowsingPlugin.lib.model.schema.sql ** Tablas del plugin sfGoogleSafeBrowsingPlugin.
+
+Ejecutaremos los script en vavag_db en el mismo orden en el que se listaron anteriormente.
+
+## Carga de los datos iniciales ##
+
+Vavag incorpora un conjunto de datos iniciales que rellenan las tablas para que Vavag funcione de forma correcta. Los datos se encuentran en ** /data/fixtures ** y Symfony incorpora un comando que carga los datos de forma automática:
+
+> ** symfony propel:data-load **
+
+Los datos iniciales incluyen la creación de tres usuarios en Vavag:
+
+* Usuario interno:
+    * Nombre: vavagint
+    * Password: vavaginttest
+
+* Usuario para la herramienta Basic Bookmarklet:
+    * Nombre: vavagbb
+    * Password: vavagbbtest
+
+* Usuario prueba:
+    * Nombre: vavaguno
+    * Password: vavagunotest
+
+** Importante: en la puesta en producción es necesario cambiar el nombre, la clave  y el API Key de estos usuarios. **
+
+El usuario más importante es el interno. Con el se realizan las operaciones abiertas de la API como la creación de una URL Corta sin iniciar sesión en la aplicación. Además, determina el dominio corto con el que se crean los enlaces para los usuarios sin sesión.
+
+
+# Configuración de los nombres de dominio #
+
+Para funcionar, vavag requiere de dos nombres de dominio. En la configuración por defecto son: 
+
+* ** vavag1.lan **: Dominio principal. Se asemeja a [vavag.com](http://vavag.com)
+* ** vavag2.lan **: Dominio para los enlaces cortos. Se asemeja a [v3g.es](http://v3g.es)
+
+Todos los enlaces cortos se generan con vavag2.lan. Este dominio se puede configurar en base de datos dentro de la tabla: ** dominio_acortador **.