Wordpress:Portales municipales:Instalación e importación de datos

AÑADIR UN NUEVO DOMINIO (Solo para nuevos cllientes)

El procedimiento comienza con la generación de un nuevo dominio. Para ello desde el panel principal de Plesk:

• En el menú lateral pulsar sobre "Dominios".
• En la lista de botones superior del área de trabajo, pulsar sobre "+ Añadir dominio".
• En la pantalla siguiente:
  • Seleccionar según el caso Sitio web en blanco (si se va a usar la herramienta de clonación) o Sitio WordPress (Se va a hacer desde 0 sin usar plantilla alguna).
  • El dominio en un principio se denominará como portalX.eprinsa.es, X será un número no repetido en los existentes.
  • En Espacio web se deja el valor por defecto (Crear una suscripción nueva)
  • El usuario se denominará eprinsa100(0)X con el mismo X del portalX.
  • Se generará contraseña y se pulsa Añadir dominio.

CONFIGURACIÓN DEL DOMINIO

Aparecerá el nuevo dominio en la lista de dominios. Aunque lo siguiente que habría que configurar es el acceso por https, si se trata del dominio en producción no puede hacerse porque el certificado necesita acceder al servidor, que aún apunta al que tiene albergado el dominio hasta que se realice el cambio. Para los otros casos, como está bajo eprinsa.es se utilizará el certificado existente. El proceso sería:

• Pulsar sobre el enlace del nombre del dominio en la lista. Aparecerán las diferentes opciones de configuración y en estas:
  • Pulsar sobre la pestaña Hosting y DNS y en ella Configuración de hosting.
    • En la configuración obligatoria "Dominio preferido" se cambia la opción www.portalX.eprinsa.es por Ninguno (necesario para que la APP funcione).
    • Habilitar la casilla "Redireccionamiento 301 permanente de HTTP a HTTPS preservando SEO" si el portal no tiene APP (en caso contrario se activará Varnish que es incompatible con esta opción).
    • Seleccionar el certificado "Wilcard EPRINSA (otro repositorio)" de la lista situada justo debajo.
    • Aceptar.

BASE DE DATOS TEMPORAL

• Sin abandonar la ventana de configuración del dominio (pestaña por defecto Panel de información):
  • Clicar en el botón "Bases de datos" y a continuación en "Añadir base de datos". Esta base de datos nada tiene que ver con la de WordPress y se usa de forma temporal para la importación de contenidos del Port@l Drupal, por lo que los datos que se piden a continuación son a voluntad:
    • Rellenar los campos obligatorios.
    • Aceptar.
  • Para la importación de los datos del port@l que se va a migrar, se deberá disponer de un fichero de volcado SQL con la exportación de la base de datos de Drupal correspondiente. Es MUY IMPORTANTE editar el susodicho fichero de volcado y efectuar una sustitución de la cadena "InnoDB" por "MyISAM" con el fin de que la nueva base de datos genere las tablas con dicho motor. Gracias a ello el proceso de importación de datos en WordPress reducirá su duración drásticamente. La importación puede hacerse de dos modos:
    • Pulsando sobre la opción "Importar volcado", cargando el fichero ".sql" y "ACEPTAR" o
    • Clicando en "phpMyAdmin", accediendo al botón "Importar" de la lista superior de opciones, cargando el fichero ".sql" (también se puede usar comprimido) y "Continuar".

CLONADO DEL WORDPRESS CANÓNICO Y CONFIGURACIÓN INICIAL

En los portalX existentes, este paso no es necesario, ya se encuentran clonados del wordpress canónico.

Si creamos un dominio nuevo que necesite de este clonado, los pasos son los siguientes:

• En la lista de dominios acceder a plantilla-portal.eprinsa.es:
  • En la nueva ventana pulsar sobre el botón clonar.
  • En la nueva ventana emergente, clicar el botón de radio Usar dominio o subdominio existente y elegir el creado en el primer punto (se puede escribir en la lista para filtrar resultados).
  • Iniciar
  • Cuando Plesk informe de que se ha completado la clonación Cerrar.

AJUSTES DE WORDPRESS

Una vez instalado WordPress aún se pueden hacer algunos ajustes dentro de esta ventana de configuración del dominio como por ejemplo revisar el estado de seguridad. Para ello, clicar en la pestaña "WordPress" y:

• Pulsar sobre el enlace "Seguridad".
  • En la ventana desplegada hacer clic sobre la casilla "Medidas de seguridad": se activarán todas.
  • Pulsar sobre el botón "Proteger".
  • Cerrar la ventana emergente.
• Pulsar sobre el enlace "Comprobar Actualizaciones" en la misma zona.
  • En la ventana desplegada hacer clic sobre el botón "Configuración de actualización"
  • En la nueva ventana superpuesta, activar los botones "Forzado" de las opciones: "Actualizar plugins de forma automática" y "Actualizar temas de forma automática".
  • OK.
  • Cerrar la ventana emergente.
  • Hacer clic en Iniciar sesión, para proceder a los siguientes ajustes.

Ajustes de Toolset

• Tras pulsar sobre "plugins", es el momento de registrar "Toolset types" y "Toolset Views" (aunque viene registrado del portal de origen, las claves son propias de cada dominio, lo que también tendrá que volver a hacerse en el dominio definitivo, una vez puesto en producción).
  • Pulsar sobre enlace "Registrado" -> botón "Cancelar el registro de Toolset en este sitio web".
  • Pulsar en el botón "Registrar toolset".
  • Abrir el enlace https://toolset.com/account/ y autenticarse en él, mediante la contraseña de Keepass → Cuentas → Plugins Wordpress → Toolset,
    • Pulsar sobre el enlace "My sites" de la barra lateral izquierda.
    • Clicar el botón "Add new site".
    • Consignar la URL del portal.
    • "Add".
    • Clic sobre "show key" y copiar la clave.
  • Acceder de nuevo al escritorio de WordPress, pegar la clave en la casilla del punto 3. del formulario de registro de toolset y pulsar "Aceptar". Registrará todos los componentes de toolset instalados.
  • En Plugins aparecerá ya como registrados los plugins de Toolset y podrán actualizarse si hay una versión nueva.

Ajustes de WP-Optimize

• Tras volver a pulsar sobre "plugins", y pulsar sobre "WP-Optimize → Imágenes":
  • Opcionalmente, seleccionar todas las imágenes no comprimidas que aparecen listadas al final de la sección y "Comprimir las imágenes seleccionadas" (el ahorro de espacio puede ser considerable).
  • Este proceso puede tardar un buen rato

IMPORTACIÓN DE LOS DATOS DE PORT@L

NOTA IMPORTANTE:
Con objeto de evitar que se puedan insertar comentarios en los contenidos importados, comprobar si está desactivada la casilla "Permitir a la gente enviar comentarios en las nuevas entradas" en Ajustes → Comentarios del menú lateral. Si no lo estaba se pueden desactivar todos los comentarios en las entradas ya importadas:
* Acceder a Entradas → Todas las Entradas.
* Marcar todas las entradas en la casilla junto a la cabecera Título.
* Elegir Editar en la lista de selección Acciones en lote.
* Aplicar.
* Escoger No permitir en la lista de selección Comentarios.

• Es necesario volver a plugins instalados. En el plugin "FG Drupal to WordPress Premium", pulsar Import para proceder a dicha importación. Se accede a una pantalla donde se piden varios datos:
  • URL of the live Drupal web site → URL del port@l que se va a migrar, teniendo en cuenta que de ahí se importarán los medios: imágenes y anexos: https://www.villaralto.es (o el del municipio que se vaya a importar).
  • Hostname → Se dejará el valor predeterminado localhost.
  • Database → El nombre utilizado al crear la base de datos, tanto si se ha respetado el original de drupal/Port@l como si es uno nuevo.
  • Username → El nombre consignado para administrar la base de datos, tanto si se ha respetado el original de drupal/Port@l como si se creó uno nuevo.
  • Password → La correspondiente al usuario anterior, en los mismos términos.
  • Drupal Table Prefix → No se modifica el valor en blanco porque no se utilizaron prefijos de tablas en port@l.
• En resumen: Drupal database parameters:

   * Driver: MySQL
   * Hostname: localhost
   * Port: 3306
   * Database: portal2_descriptor (por ejemplo, portal2_villaral)
   * Username: portal2_descriptor (por ejemplo, portal2_villaral)
   * Password: hacer el echo -n descriptor|md5sum y añadir la # si se ha utilizado ese símbolo para que la clave de la base de datos sea segura.

• "Test Database connection". Si los datos introducidos son los correctos, en la caja de "log" se verá un resumen totalizado de los contenidos que hay en la base de datos pero si no muestra los datos en dicha ventana consúltese esta nota.
• Es muy conveniente ajustar el parámetro "Timeout for each media: seconds" a al menos 60 segundos (5 por defecto y 90 recomendables, por mucho que ralentice la importación), para evitar que las imágenes o archivos grandes no se importen por ese motivo.
• También como consecuencia de la ejecución del test de conexión aparecerán los tipos de contenido disponibles en la base de datos de Drupal pulsando sobre el enlace "Expand/collapse" a la derecha de "Partial import" en la sección "Behavior" que está a continuación de "Drupal database parameters". De esa lista se evita la migración de tipos de contenido:
  • haciendo clic en la casilla "Don't import the nodes of type ..." para cada uno de estos: "Agenda" (se utilizará un calendario Google"), "Banner" (elemento decorativo que se analiza individualmente), "Enlace" (elemento que se maqueta individualmente), "Formulario" (se usa un plugin específico), "Page" (las páginas "básicas" no llegaron a usarse en Port@l) y "Panel" (no usado en Port@l):
• Conviene evitar también la importación de menús pues en port@l el único nativo de Drupal que se usó fue para el perfil de contratante, que queda sin uso en WordPress. También se evitará la importación de comentarios:
  • Para ello se hace clic en las casillas de las opciones "Don't import the menus" y "Don't import the comments", que están bajo el bloque de tipos de contenido (visible sin necesidad de pulsar sobre "Expand/collapse").
• Y tras la implantación de la autenticación por AD en Wordpress, tampoco es necesario importar ya los usuarios, sino que habrá que pedir al responsable del ayuntamiento, cuáles son los que van a acceder a la edición de contenidos. De manera que:
  • También se hace clic en la casilla de la opción "Don't import the users" justo antes de los dos anteriores..
• "Start / Resume the import" (el proceso puede tardar bastante tiempo, dependiendo del número de contenidos).

OTRA NOTA IMPORTANTE:
Para evitar incidencias en la importación de bases de datos con un gran número de elementos (en particular noticias, genéricos y documentos, con más de mil contenidos de alguno o varios de ellos) se recomienda:
* Importar en un primer paso los genéricos y documentos junto con las páginas no básicas (Non-basic pages), excluyendo las noticias (articles), haciendo uso de la casilla "Don't import the nodes of type ...".
* Importar de manera independiente las noticias en una importación posterior.
* Apuntar los ficheros no importados, por errores cURL 18 o 28 para luego incorporarlos desde el administrador de medios. Generalmente estarán bajo "portal2.descriptor/sites/default/files/..."
* Comprobar regularmente en otra pestaña el número de contenidos importados (sobre todo las entradas): si no aumenta durante mucho tiempo sin haber llegado al total, se recomienda comprobar en el administrador de medios si su número está aumentando y si no, en la pestaña de la importación actualizar con F5 y pulsar de nuevo "Start / Resume the import", que reanudará el proceso por donde se interrumpió.

En el log de importación va apareciendo información de cómo va el proceso, los mensajes que aparezcan en rojo, sobre todo aquellos relacionados con errores cURL 18 ("transfer closed with xxxxx bytes remaining to read") o 28 ("Operation timed out after XXXXX milliseconds with X bytes received") indican los ficheros que luego se habrán de importar manualmente. Otros mensajes del tipo "Can't copy https://dominio/public://field/image/fichero to /var/www/vhosts/dominio-provisional/httpdocs/wp-content/uploads/yyyy/mm/fichero : Not Found" tienen que ver con la codificación del fichero en origen y no se importarán.

• Al finalizar la importación conviene pulsar sobre el botón "Modify internal links" en la parte inferior (Sección "After the migration") en prevención de que existan enlaces entre artículos, aunque esto es poco probable.
• OJO: Si bien en el proceso de migración se añaden todos los anexos, estos no se mostrarán en la salida. En caso necesario tendremos que editar la/s noticia/s en cuestión y añadirle los mismos editándolos con Divi y como contenido multimedia dentro del texto de la/s noticia/s.

SI EL PORT@L TIENE APP...

En el caso de los VIP, se deben importar todos los contenidos y taxonomías que se usan en la APP. Para ello, se accede al plugin FG Drupal y se configura como se muestra en la imagen:

Una vez realizada la importación, en el menú lateral de WordPress, aparecerán los contenidos Correo electrónico de incidencias, Enlaces de la app e Incidencia. En Correo electrónico de incidencias, hay que cerciorarse que se han creado las Categorias Web Movil. Por último, hay que comprobar que los datos importados son correctos comparándolos con la versión original.

SI EL PORT@L TIENE LISTADO DE DIRECTORIOS...

Tras el proceso de importación conviene revisar si se ha importado una página "Directorio telefónico", "Teléfonos de interes", o similar en cuyo caso se deberá hacer algún trabajo adicional de configuración en dicha página que consiste en los siguientes :

• En el menú lateral de Wordpress entrar en Eprinsa → Gestión de Listado de Directorios. Se muestran las opciones de configuración del listado telefónico así como las taxonomías de Secciones de directorio existentes en la web actual.
  • Si no hubiera ninguna sección de directorio, el plugin de Gestión de Listado de Directorios debe volver a leer los datos. Para ello:
    • acceder a Plugins del menú lateral y Desactivar y Activar el plugin "Gestión de Listado de Directorios".
    • Volver a la configuración de este plugin Eprinsa → Gestión de Listado de directorios y ya aparecerán las secciones de directorio importadas.
• Acceder a Toolset → Exportar / Importar del menú lateral y posteriormente a la pestaña "Views".
  • Pulsar sobre el botón Examinar y elegir el fichero "/almacen/CMS/WordPress/Recursos/listado-directorio/listado-directorios.views.version.zip".
  • Importar.
• La importación no incorpora ciertos shortcodes necesarios para visualizar los campos no obligatorios del directorio. Para incorporarlos:
  • Acceder a Toolset → Views (vistas).
  • Editar la vista "Listado de directorios 2".
  • Bajar hasta el "editor de bucle" y en la lista de botones sobre la caja con el código pulsar "Salida condicional".
    • En la ventana emergente pulsar en el menú lateral izquierdo la opción "Configuración adicional".
    • Consecutivamente, en la caja "Nombre de shortcode", escribir mostrar-direccion-directorio, mostrar-url-directorio, mostrar-geolocalizacion-directorio, mostrar-email-directorio y mostrar-mapa pulsando el botón "+ Agregar" tras cada nombre.
    • Realizar el mismo proceso en la caja "Nombre de función", escribiendo mostrar_direccion_directorio (Obsérvese que ahora los guiones son bajos), mostrar_url_directorio, mostrar_geolocalizacion_directorio y mostrar_email_directorio también pulsando el botón "+ Agregar" cada vez.

Esto importará una tabla con los directorios del portal sin ningún estilo CSS. Si se quiere cambiar la apariencia de la tabla, accedemos al plugin Toolset: Views->Listado de directorios 2 -> Configuración del bucle -> CSS se puede añadir estilos, algo así:

    .et_pb_text_inner thead {border: 1px solid  rgba(49,100,0,0.15);background-color: rgba(49,100,0,0.15); font-size: 1.4em;}
    .et_pb_text_inner tbody {font-weight:normal;}
Nota 13-04-2021: Se han habilitado otras vistas donde se puede filtrar por secciones de directorio, debido a que en Almedinilla y posteriormente otros portales se estaban usando varios directorios con el filtrado mencionado. Si es necesario, se importará el fichero de vistas "listado-directorios.views_filtrado_secciones.2021-04-13.zip" del mismo directorio y se utilizarán idénticos shortcodes añadiendo el slug de la sección de directorio correspondiente, o secciones, separadas con comas.

Ejemplo 1: [wpv-view name="listado-de-directorios-con-busqueda" wpvseccionesdirectorio="lineas-fijas-municipales"]

Ejemplo 1 bis: [wpv-view name="listado-de-directorios-con-busqueda" wpvseccionesdirectorio="lineas-fijas-municipales, servicios-municipales"]

Ejemplo 2: [wpv-view name="listado-de-directorios-2" wpvseccionesdirectorio="lineas-fijas-municipales"]

• Si el directorio tiene campos adicionales a los "Denominación" y "Teléfono", establecidos por defecto, se deberá acceder a la "Gestión Listado Directorios" del menú lateral y activar las casillas correspondientes a los campos adicionales.
• Ir al listado de páginas desde el menú lateral y editar con Divi la página correspondiente al Listado de directorios.
  • Se crea una sección y fila (de ancho completo) si no existen ya y se inserta un módulo texto de Divi builder.
  • En el cuerpo del módulo se introduce el texto [wpv-view name="listado-de-directorios-2"] (o también [wpv-view name="listado-de-directorios-con-busqueda"], si tiene buscador en origen) y se pulsa sobre el botón de validar.

CONFIGURACIÓN DEL SUBDOMINIO DE TRANSPARENCIA (SOLO PARA NUEVOS CLIENTES, LOS ACTUALES ESTÁN ABIERTOS)

La necesidad de disponer de un portal de transparencia en cada municipio, con unos diseños y ajustes específicos, determinó la idoneidad de generar un subdominio en cada uno de los municipios con un WordPress supeditado a él del tipo transparencia.municipio.es y gestionado según los subdominios de WordPress multisite, para evitar la necesidad de acceder a escritorios diferentes, por parte del personal del ayuntamiento.

ADICIÓN DEL SUBDOMINIO

Como paso previo es necesario crear el subdominio en plesk para lo cual se seguirán las mismas instrucciones que en AÑADIR UN NUEVO DOMINIO con los cambios:

• En lugar de pulsar sobre "Añadir dominio" se hará sobre "Añadir subdominio"
• En la caja de texto "Nombre del subdominio" se escribirá transparencia.

Accediendo al escritorio del dominio plantilla-transparencia.eprinsa.es (nota *) en el menú lateral de plesk (opción Dominios):

• Hace clic sobre Clonar, de la zona de botones superior y en la ventana emergente:
  • En los botones de radio de Destino: seleccionar la opción Usar dominio o subdominio existente.
  • En la lista de selección seleccione un dominio escoger el que se creó en el paso anterior.
  • Iniciar.

¿QUÉ HACER A CONTINUACIÓN?

Los pasos siguientes para poner a punto la sede web del dominio municipal se exponen en Ajustes y puesta a punto