From 43fb1f374d4ce67ab0bb6ffe1bf7e6bee05496a5 Mon Sep 17 00:00:00 2001 From: Yaco Date: Sat, 10 Aug 2019 11:08:51 -0300 Subject: agrega documentacion de ImportarDesdeURL y ImportarExperiencia --- README.md | 74 +++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 60 insertions(+), 14 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 9ada3799..3f463c98 100644 --- a/README.md +++ b/README.md @@ -9,10 +9,31 @@ Repositorio de código de la plataforma unificada de REEVO, correspondiente al p ## Instalación +### Configurar y activar Nginx y php-fpm + +Activar configuracion en Nginx, hay que editar ```/etc/nginx/nginx.conf``` agregando al final: ```include /srv/reevo-2020/etc/nginx/*.conf;``` + +Activar configuracion en php-fpm, hay que editar ```/etc/php/7.3/fpm/php-fpm.conf``` agregando al final: ```include=/srv/reevo-2020/etc/php-fpm/*.conf;``` + +Luego creamos los archivos de configuracion en /etc + +### Crear base de datos + +En la consola de MYSQL: + +``` +CREATE DATABASE reevo2020_wiki; + +CREATE USER 'reevo2020'@'localhost' IDENTIFIED BY 'my-strong-password-here'; + +GRANT INDEX, SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, ALTER, CREATE TEMPORARY TABLES, LOCK TABLES ON reevo2020_wiki.* TO 'reevo2020'@'localhost'; +``` + + Para generar las tablas en la base de datos hacemos (no usamos el ```LocalSettings.php``` resultante): ~~~ -php www/wiki/maintenance/install.php --dbname= --dbserver="localhost" --installdbuser= --installdbpass= --dbuser= --dbpass= --server="http://reevo.test" --scriptpath=/ --lang=es --pass= "REEVO TEST" "Admin" --confpath /var/dump +php www/wiki/maintenance/install.php --dbname=reevo2020_wiki --dbserver="localhost" --installdbuser=reevo2020 --installdbpass= --dbuser=reevo2020_wiki --dbpass= --server="http://reevo.red" --scriptpath=/ --lang=es --pass=yaco22 "REEVO" "Admin" --confpath /var/dump ~~~ Cargamos los datos para conectar con la base de datos en ```etc/global_config.php```. @@ -23,28 +44,35 @@ Corremos el script para generar tablas y cambios de las extensiones: ```php /srv Para correr la actualización de variable de SMW y demas: ```php /srv/reevo-2020/www/wiki/maintenance/runJobs.php``` -## Documentación de herramientas propias +### Crear usuario para API -### Cargar páginas, propiedades y formularios +Creamos el usuario de API -* Script: ```bin/wiki/initReevo.php``` -* Descripción: se usa para crear o actualizar las páginas con propiedades, plantillas, formularios que se alojamos en ```bin/wiki/reevoPages```. Luego de crear o actualizar, se protegen para que solo los admins puedan editarlas. +``` +php createAndPromote.php --bureaucrat --sysop reebot -Para crear todas las páginas: +php resetUserEmail.php reebot reebot@reevo.org -```cd bin/wiki/ && php initReevo.php --int``` +php changePassword.php --user=reebot --password= +``` -Para actualizar todas las páginas cuando ya están creadas: +Y luego cargamos las credenciales en global_config.php -```cd bin/wiki/ && php initReevo.php --int --force``` -Para actualizar solo las que pertenecen a un namespace: +## Documentación de herramientas propias -```cd bin/wiki/ && php initReevo.php --int --force NameSpace``` +### Cargar páginas, propiedades y formularios + +* Script: ```bin/wiki/initReevo.php``` +* Descripción: se usa para crear o actualizar las páginas con propiedades, plantillas, formularios que se alojamos en ```bin/wiki/reevoPages```. Luego de crear o actualizar, se protegen para que solo los admins puedan editarlas. + +Para crear todas las páginas: ```cd bin/wiki/ && php initReevo.php --int``` -Para actualizar una página en particular: +Para actualizar todas las páginas cuando ya están creadas: ```cd bin/wiki/ && php initReevo.php --int --force``` -```cd bin/wiki/ && php initReevo.php --int --force Propiedad:Prensa:url``` +Para actualizar solo las que pertenecen a un namespace: ```cd bin/wiki/ && php initReevo.php --int --force NameSpace``` + +Para actualizar una página en particular: ```cd bin/wiki/ && php initReevo.php --int --force Propiedad:Prensa:url``` ### Generador de archivos de prensa @@ -61,7 +89,9 @@ Para actualizar una página en particular: Se usa el elgg-cli para exportar los datos: -```/srv/reevo-web/www/red/vendor/hypejunction/elgg-cli/elgg-cli user:get --username=Yaco``` +``` +/srv/reevo-web/www/red/vendor/hypejunction/elgg-cli/elgg-cli user:get --username=Yaco +``` Para que el usuario API funcione, tiene que tener el email validado, para hacerlo por consola: @@ -73,3 +103,19 @@ php changePassword.php --user=User --password=password No anda el script de extraccion de ELGG si esta activado el plugin ```profile_manager_joingroups``` Se puede importar desde la línea de comandos cualquier usuario de ELGG con este comando: ```php bin/wiki/ImportarPerfil.php -f true -u ``` + + +### Migrar experiencias desde Ushahidi + +Tenemos una aplicacicón web para procesar una a una las experiencias de Ushahidi. Disponible en http://reevo.test/ImportarExperiencia/ + + +### Importar pagina de prensa desde URL + +Existe la aplicacion web (http://reevo.test/ImportarDesdeURL/) que permite precargar el formulario de creación del objeto Prensa a partir de los metadatos de una URL. + +Para que funcione, hay que instalar metascraper y otras aplicaciones de nodejs: + +``` +sudo npm install metascraper metascraper-author metascraper-date metascraper-description metascraper-image metascraper-logo metascraper-clearbit metascraper-publisher metascraper-title metascraper-url franc-cli got minimist --global +``` -- cgit v1.2.1