MediaWiki — Instalación y más

MediaWiki es un software gratuito, open-source que puedes usar para crear contenido wiki, tal como Wikipedia. La aplicación es ideal para crear páginas de bases de conocimiento similares a una enciclopedia.

MediaWiki puede ser instalada manualmente en los servidores de DreamHost.

• MediaWiki.org

1. Descarga MediaWiki de su sitio en:
   • MediaWiki
2. Crea una base de datos que será usada por MediaWiki. Visita el siguiente artículo para más información:
   • Crear una base de datos
3. Configura tu dominio para usar PHP 8.1 o una versión superior. Revisa los siguiente artículos para obtener más información:
   • Cambiar la versión PHP de un sitio
   • MediaWiki PHP Compatibility

Puedes encontrar instrucciones detalladas sobre la instalación manual de MediaWiki en el siguiente artículo:

• Guía de instalación manual de MediaWiki

1. Carga el archivo MediaWiki que descargaste a tu servidor web a través de FTP.
2. Inicia sesión en tu servidor a través de SSH, luego descomprime el archivo en el servidor.
3. Confirma que los archivos de MediaWiki están en el directorio web de tu dominio. Es posible que debas copiarlos desde un directorio mediawiki-x.xx.x recién creado al directorio root.
4. Apunta tu navegador a mw-config/index.php en tus archivos MediaWiki extraídos, lo que abre la pantalla de configuración. Por ejemplo:
   • http://example.com/mw-config/index.php
5. Sigue las instrucciones en pantalla para completar el proceso.
   Una vez que se completa el proceso de instalación, se descarga un archivo LocalSettings.php en tu navegador.
6. Carga el archivo LocalSettings.php a tu carpeta de instalación de MediaWiki en el servidor web a través de FTP.

Extensiones

MediaWiki ofrece muchos tipos diferentes de extensiones que puede usar para agregar más funcionalidad y personalización a tu sitio. Consulta el siguiente artículo para obtener más detalles:

• Extensiones MediaWiki

Google Analytics

También puedes agregar Google Analytics a tu instalación de MediaWiki si lo deseas. Consulta el siguiente artículo para obtener instrucciones detalladas:

• Integración de Google Analytics

Problemas de miniaturas/thumbnails

MediaWiki ocasionalmente puede tener problemas para generar miniaturas de imágenes, como devolver imágenes corruptas o el mensaje de error "Error creating thumbnail". Una causa común de esto es que no hay suficiente memoria.

Si cargas una imagen grande y ves "Error creating thumbnail" donde debería estar una miniatura, intenta agregar lo siguiente a tu archivo LocalSettings.php en el directorio primario de tu sitio:

$wgMaxShellMemory = 524288;

Imagenes SVG

Para obtener los mejores resultados en la generación de miniaturas de imágenes SVG, puedes instalar librsvg.

Suplantación de dominio

Agrega lo siguiente a tu archivo LocalSettings.php:

$wgUserEmailUseReplyTo = true;

Esto falsifica el dominio para que el correo del usuario que envía esté en un encabezado Responder en lugar del encabezado Remitente. De lo contrario, el correo que los usuarios intentan enviarse entre sí a través de Special: EmailUser en tu wiki no se puede entregar.

Notificaciones

Dada la cuota de SMTP, debes tener cuidado si habilitas $wgEnotifWatchlist.

Si una página está 'watchlisted' por 100 usuarios que tienen habilitada esa preferencia de usuario, entonces un cambio en esa página agota su cuota durante una hora, si estás en un Shared Hosting.

Bloquear spam de MediaWiki

Combatier SPAM

Proporciona los pasos que puedes seguir para combatir el SPAM en tu sitio web.

MediaWiki Wiki Spam

Descripción de qué es el spam de wiki e instrucciones sobre cómo cualquier usuario puede ayudar a resolver el problema de spam de wiki (no solo los administradores). No todo es obvio, por lo que vale la pena que los administradores lo lean también, ya que es posible que desees referir a tus usuarios de wiki a esto.

CAPTCHA

Habilitar un Captcha en cualquier formulario ayuda a reducir el spam.

Restringir la creación de cuentas

Por defecto, cualquiera puede crear una cuenta en tu wiki. Sin embargo, puedes restringir quién tiene la capacidad de crear cuentas.

Derechos de usuario

También tienes control sobre los derechos de usuario. Puedes deshabilitar las ediciones sin usuario con esta característica.

Scripts de mantenimiento

En la instalación root de MediaWiki, hay un subdirectorio llamado /maintenance que incluye varios scripts que puedes ejecutar en tu instalación de MediaWiki. Para ejecutar los scripts PHP, debes crear un usuario Shell (SSH) en tu dominio.

Para correr los scripts, debes ingresar php antes del nombre del archivo. Por ejemplo, corre el siguiente comando si deseas ejecutar el script eval.php en el directorio de mantenimiento:

[server]$ php eval.php

Para obtener más información sobre los scripts individuales, consulta el siguiente artículo:

• Scripts de mantenimiento

Almacenamiento en caché

El almacenamiento en caché de tu sitio puede mejorar el rendimiento. Hay varias formas de almacenar en caché tus datos usando MediaWiki. Consulta los siguientes artículos para obtener más información:

• Almacenamiento en caché MediaWiki
• Caché de archivos

Habilitar cargas

Consulta la siguiente guía para obtener instrucciones sobre cómo habilitar la carga de archivos:

• Configurar la carga de archivos

Generando copias de seguridad

Consulta la siguiente guía para obtener instrucciones sobre cómo hacer una copia de seguridad de tus datos:

• Generar una copia de seguridad de MediaWiki

Además, consulta el siguiente artículo de DreamHost para obtener más instrucciones:

• Copias de seguridad

Contraseñas y HTTPS

MediaWiki utiliza un formulario en una página web HTTP para tomar tu contraseña. Esto significa que tu contraseña se transmite a través de la red en texto claro. Para usar HTTPS, debes agregar un certificado SSL.

Permisos LocalSettings.php

El archivo LocalSettings.php almacena la información de inicio de sesión de tu base de datos, incluido el nombre de usuario y la contraseña de la base de datos. Después de mover el archivo LocalSettings.php a tu directorio root, puedes revisar tus permisos.

Debes actualizar los permisos en ese archivo a 640 o 600. Esto se puede hacer corriendo el siguiente comando:

[server]$ chmod 640 LocalSettings.php

Esto hace que el archivo solo se pueda escribir por el propietario, mientras que el grupo aún puede leerlo. Sin embargo, la opción más segura es marcar el archivo como solo legible/editable por el propietario:

[server]$ chmod 600 LocalSettings.php

De esta manera, tu contraseña de MySQL en este archivo está a salvo de que otros usuarios la vean en el mismo servidor. Mira el siguiente artículo para obtener más detalles sobre los permisos:

• Permisos de archivo Unix

Mover las credenciales de la base de datos a otro archivo

Otra buena práctica de seguridad es configurar un archivo PHP separado almacenado en el directorio de tu usuario. Este archivo almacena tus credenciales y las pasa como variables. La siguiente configuración describe cómo vincular tu archivo LocalSettings.php a este nuevo archivo:

1. En el directorio de tu usuario (no el directorio del dominio), crea un nuevo directorio llamado external_includes.
2. En esta nueva carpeta, crea un archivo llamado database_info.php.

   La ruta completa a este nuevo archivo es:

   /home/username/external_includes/database_info.php

   Asegúrate de cambiar el username a tu usuario Shell. El archivo incluye lo siguiente (llena tus datos reales entre las comillas):

   <?php
    $database_server = "mysql.example.com"; 
    $database_name   = "databasename"; 
    $database_user   = "username";
    $database_pw     = "password";
    ?>
   

3. Elimina las credenciales de la base de datos actual en tu archivo LocalSettings.php.
4. Reemplaza esas lineas con lo siguiente:
   

   # enhanced DB security
    require_once ("/home/username/external_includes/database_info.php");
    
    $wgDBserver     = $database_server;
    $wgDBname       = $database_name;
    $wgDBuser       = $database_user;
    $wgDBpassword   = $database_pw;
    
    # DB variables not security related - leave these alone from how when you set up your wiki
    $wgDBprefix     = "wiki_";
    $wgDBtype       = "mysql";
   

Con esta configuración, tus credenciales en el archivo LocalSettings ahora están ocultas de forma segura.

Puedes seleccionar qué licencia de MediaWiki deseas utilizar. Mira el siguiente artículo para más detalles:

• GFDL vs CC

Siempre asegúrate de hacer primero una copia de seguridad de los archivos de tu base de datos y sitio web antes de hacer cualquier ajuste. De esta manera, si algo fallara, podría reemplazar rápidamente tus archivos. Mira el siguiente artículo para más detalles:

• Respaldar una cuenta en el panel

Consulta la siguiente guía en mediawiki.org para obtener instrucciones de actualización:

• Actualizar

[server]$ php /maintenance/update.php

[server]$ /usr/local/php81/bin/php maintenance/update.php

Habilitar debugging

Puedes habilitar la depuración agregando líneas en la parte inferior de archivo LocalSettings.php. Al habilitar esto, se te proporciona información de depuración detallada para ayudar a aislar la causa.

Revisa el siguiente artículo para obtener más detalles:

• Cómo depurar

Después de que termines de solucionar los problemas de tu instalación, debes deshabilitar la configuración de depuración.

URLs cortas

Puedes acortar las URL para que parezcan más fáciles de usar. Por ejemplo, puedes cambiar el siguiente ejemplo de URL:

example.com/w/index.php?title=Main_Page

a

example.com/wiki/Main_Page

Revisa los siguientes artículos para obtener más instrucciones:

• URLs cortas
• Constructor de MediaWiki de URLs cortas

Arreglar MediaWiki después de agregar un certificado SSL a un dominio

Puedes notar que MediaWiki se carga incorrectamente o muestra advertencias de 'contenido inseguro' en la barra del navegador después de agregar un certificado SSL al dominio donde está instalado MediaWiki.

Tu archivo LocalSettings.php debe ser editado para reflejar HTTPS para tu dominio. Para solucionarlo, busca el valor $wgServer en el archivo LocalSettings.php y asegúrate de que el dominio muestre HTTPS (y no HTTP) para el valor de URL:

## The protocol and server name to use in fully-qualified URLs
$wgServer = "https://www.example.com";

Después de hacer esta edición, guárdala y luego transfiere el archivo LocalSettings.php a la carpeta wiki root en tu servidor. Actualiza tu navegador y MediaWiki debería cargarse normalmente.