View source for InstantCommons/es

<languages/>
[[File:InstantCommons2.png|thumb|375px|Indica el nombre de una imagen de Commons en cualquier instalación de MediaWiki...]]
[[File:InstantCommons1.png|thumb|375px|... y la imagen se obtiene de Commons y se inserta en la página]]
'''InstantCommons''' es una función de MediaWiki que permite usar cualquier archivo multimedia subido a [[m:Special:MyLanguage/Wikimedia Commons|Wikimedia Commons]] en cualquier instalación de MediaWiki de todo el mundo.

<span id="Rationale"></span>
==Justificación==
Desde {{ym|2023|11}}, [[m:Special:MyLanguage/Wikimedia Commons|Wikimedia Commons]], el repositorio central de archivos multimedia hospedado por la [[m:Special:MyLanguage/Wikimedia Foundation|Fundación Wikimedia]], contiene más de 100 millones de archivos.
Todos y cada uno de estos archivos están disponibles bajo una licencia de contenido libre o bien en el dominio público; no existe ninguna otra restricción que afecte a su uso más allá del posible uso de insignias oficiales o de marcas registradas.
Las licencias que limitan la utilización comercial se consideran como no libres.

A medida que crece la popularidad de Commons, también lo hace el deseo por parte de terceros de usar su contenido, y de contribuir con nuevo material.
En la actualidad es técnicamente posible cargar imágenes directamente desde los servidores de Wikimedia en el contexto de cualquier página web. El uso de enlaces directos de este modo está permitido, pero resulta problemático por varias razones:

* No respeta los términos de licencia de la imagen, y no permite la transferencia de forma fiable de otra información extra (metadatos) que también sería deseable transferir
* Además de no dar el crédito correspondiente al autor del archivo multimedia, tampoco da ningún reconocimiento a Wikimedia
* Consume ancho de banda de Wikimedia cada vez que se visita una página (a menos que la imagen se haya almacenado en caché en el lado del cliente o mediante un proxy; esta funcionalidad está actualmente deshabilitada de forma predeterminada)
* No facilita ciertas operaciones útiles como pueden ser la generación de miniaturas y añadir un pie de foto a las mismas, y es difícil de usar en el contexto de un wiki, particularmente para operaciones comunes de presentación de contenidos
* Es un sistema atado a los URLs como identificadores de recursos, lo que dificulta el uso de sitios espejo
* Crea una web con un uso de recursos externos no monitorizable, donde cualquier cambio en el lado de Wikimedia afectaría necesariamente a los usuarios externos
* No permite el visionado sin conexión a Internet, algo crucial en países que sólo cuentan con un acceso intermitente a la red.

InstantCommons busca dar solución a todo esto proporcionando un método sencillo para la carga (cacheada) de imágenes y metadatos desde los servidores de Wikimedia.
Si bien la funcionalidad de caché es parte del objetivo, esta funcionalidad está desactivada desde MediaWiki 1.27.2/1.28.1.
InstantCommons se implementó originalmente en el código de MediaWiki, permitiendo que todas las operaciones de MediaWiki relacionadas con imágenes (miniaturización, añadido de pies de foto, galerías, etc.) pudieran realizarse de forma transparente.
Otros motores wiki pueden implementar una funcionalidad similar usando las operaciones a nivel de API que se describen más abajo.

<span id="Basic_feature_set"></span>
== Características básicas ==

Durante la instalación, la persona que administra el sitio puede decidir si quiere activar InstantCommons. Lo ideal, sin embargo, sería que esta característica estuviese activada por defecto (suponiendo que se indique un directorio para las subidas en el que MediaWiki pueda escribir) para permitir que el mayor número posible de usuarios utilice los contenidos de Wikimedia Commons.

Si la característica está activada, el wiki se comporta como cualquier proyecto de Wikimedia, es decir, si se hace referencia a una imagen o cualquier archivo multimedia que existe en Commons, puede incluirse en una página del wiki como cualquier otro archivo subido de forma local, indicando simplemente su nombre. Si existe un archivo local con ese nombre, tendrá preferencia sobre el contenido de Commons.

<span id="Configuration"></span>
== Configuración ==

<span id="Default_method:_$wgUseInstantCommons"></span>
=== Método por defecto: $wgUseInstantCommons ===

Para habilitar InstantCommons en MediaWiki 1.16 y versiones posteriores, basta con agregar esta línea a tu archivo <code>LocalSettings.php</code> (mira {{ll|Manual:$wgUseInstantCommons|$wgUseInstantCommons}} para más detalles):

<syntaxhighlight lang="php">
$wgUseInstantCommons = true;
</syntaxhighlight>

<span id="Classic_InstantCommons_with_local_thumb_caching"></span>
=== InstantCommons clásico con caché local de miniaturas === 
El método por defecto para habilitar InstantCommons usando $wgUseInstantCommons utiliza miniaturas enlazadas directamente desde Wikimedia.<ref>
https://gerrit.wikimedia.org/r/c/mediawiki/core/+/251556/1/includes/Setup.php
</ref>
Esto puede resultar lento y también interferir con el caché de archivos (enlaces rotos).
Si prefieres generar y usar las miniaturas directamente en tu sitio web, no uses <code>$wgUseInstantCommons</code>.
En lugar de esto, inserta este código en LocalSettings.php tal como se describe aquí: [[Special:MyLanguage/Manual:$wgForeignFileRepos#Usage|Manual:$wgForeignFileRepos#Uso]].

<syntaxhighlight lang="php">
$wgForeignFileRepos[] = [
	'class' => ForeignAPIRepo::class,
	'name' => 'commonswiki', // Debe ser un nombre único
	'apibase' => 'https://commons.wikimedia.org/w/api.php',
	'hashLevels' => 2,
	'fetchDescription' => true, // Opcional
	'descriptionCacheExpiry' => 43200, // 12 horas, opcional (en número de segundos)
	'apiThumbCacheExpiry' => 86400, // 24 horas, opcional, pero requerido para el caché local de miniaturas
];
</syntaxhighlight>

<span id="Using_files_via_InstantCommons"></span>
== Uso de archivos mediante InstantCommons ==
[[File:Wikipedia-Marker-commons.svg|thumb|Una foto de Wikimedia Commons utilizada en este wiki]]
Teniendo activado InstantCommons, puedes elegir cualquier imagen de Wikimedia Commons (por ejemplo [//commons.wikimedia.org/wiki/File:Wikipedia-Marker-commons.svg ésta]), pulsar el botón "Usar este archivo" (el botón que tiene a su lado un icono [[File:Tango_style_Wikipedia_Icon.svg|20px|link=]] de wiki) y pegar el código en tu wiki.
En nuestro ejemplo, pegar

<pre>
[[File:Wikipedia-Marker-commons.svg|thumb|Una foto de Wikimedia Commons utilizada en este wiki]]
</pre>

hará que aparezca la vista en miniatura, tal como puede verse al lado derecho de esta página.

Fíjate en que al usar archivos de este modo, sigues teniendo la obligación de respetar los términos de su licencia y cualquier otro requerimiento legal establecido sobre su uso - mira [[:commons:Commons:Reutilización del contenido fuera de Wikimedia|Commons:Reutilización del contenido fuera de Wikimedia]].

<div lang="en" dir="ltr" class="mw-content-ltr">
== Troubleshooting ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Common thumbnail sizes ===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">Since early 2026, Wikimedia image servers prefer to generate thumbnail images with predefined widths.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The rate limiting applied to sizes outside of the predefined widths is quite strict.</span>
The {{ll|Common thumbnail sizes}} can be used along with {{wg|ThumbnailSteps}} to limit the image sizes used in the {{tag|img|open}} HTML tags generated by MediaWiki.
<span lang="en" dir="ltr" class="mw-content-ltr">When active these settings make your MediaWiki emit HTML that puts whatever <code>width</code> and <code>height</code> attribute is appropriate on generated {{tag|img|open}} tags while also selecting the exact match or next largest width from the step sizes for the image requested from upload.wikimedia.org.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Adding <syntaxhighlight lang=php inline>$wgThumbnailSteps = [20, 40, 60, 120, 250, 330, 500, 960, 1280, 1920, 3840];</syntaxhighlight> and <syntaxhighlight lang=php inline>$wgThumbnailStepsRatio = 1;</syntaxhighlight> in your LocalSettings.php will make your MediaWiki match the expected sizes.</span>

{{Anchor|Temporary_solution|Set_custom_user_agent}}
<div lang="en" dir="ltr" class="mw-content-ltr">
=== User-Agent Policy ===
</div>
{{Note
| type = warn
| text = <span lang="en" dir="ltr" class="mw-content-ltr">If your wiki is throttled by Wikimedia Commons, please update to MediaWiki 1.45.0 (or MediaWiki 1.39.14+, 1.43.4+, or 1.44.1+) to comply with the [[foundation:Policy:Wikimedia_Foundation_User-Agent_Policy|User-Agent Policy]].</span>
}}
<span lang="en" dir="ltr" class="mw-content-ltr">Since late 2025, Wikimedia Commons may categorize API requests from your server as unidentified and throttle or block its requests.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">This is due to enforcement of the [[foundation:Policy:Wikimedia_Foundation_User-Agent_Policy|Wikimedia Foundation User-Agent Policy]] and protects against increases in automated scraping.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">Prior to MediaWiki 1.45, the User-Agent header in InstantCommons did not include a source URL, as required by the policy.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If you encounter a rate limit message when using InstantCommons, please upgrade to MediaWiki 1.45.0 (or MediaWiki 1.39.14+, 1.43.4+, or 1.44.1+) which sets a compliant header that includes the wiki's server URL.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">High traffic wikis may additionally need to follow [[wikitech:Bot_traffic|Bot traffic requirements]] by verifying the server's IP range.</span>

<span id="HTTPS"></span>
<div class="mw-translate-fuzzy">
== HTTPS ==
</div>

Desde junio de 2015, Wikimedia Commons sólo es accesible por medio de [[meta:Special:MyLanguage/HTTPS|HTTPS]]. Algunas instalaciones pueden carecer de su almacén de certificados raíz, impidiendo que MediaWiki pueda conectarse a Commons mediante HTTPS. Si InstantCommons deja de funcionar, prueba lo siguiente:

* Instala la extensión [https://php.net/book.curl php curl] (generalmente es más fiable y más probable que disponga de los certificados necesarios ya instalados). En Debian/Ubuntu: <code>sudo apt-get install php-curl</code>
* Asegúrate de que tienes un almacén de certificados al día. Si tienes instalada la extensión de curl para php, sigue las instrucciones de [https://snippets.webaware.com.au/howto/stop-turning-off-curlopt_ssl_verifypeer-and-fix-your-php-config/ webaware] o [[Talk:InstantCommons/Archive_2#Stop_working|Talk:InstantCommons#Stop_working]].
* <span class="mw-translate-fuzzy">La funcionalidad debería entonces estar disponible de forma inmediata. Si no es así, comprueba si la función <code>curl_exec()</code> de PHP está desactivada en tu servidor web.</span>

<span id="SElinux"></span>
<div class="mw-translate-fuzzy">
== SElinux ==
</div>
Si el SO de tu servidor utiliza SElinux, por favor, consulta la [[Special:MyLanguage/SELinux#Enabling InstantCommons|sección dedicada]] en {{ll|SELinux}}, y asegúrate de que los scripts y módulos HTTPD pueden acceder a la red.
Si SElinux impide que los scripts y módulos HTTPD conecten con el repositorio de Wikimedia Commons, InstantCommons simplemente no funcionará.

<span id="Behind_a_firewall"></span>
<div class="mw-translate-fuzzy">
== Detrás de un cortafuegos ==
</div>

Si el servidor en el que corre el wiki se encuentra detrás de un cortafuegos, el servidor wiki debe disponer de la posibilidad de enviar peticiones http/https a commons.wikimedia.org y upload.wikimedia.org para que InstantCommons funcione. El rango de direcciones IP puede consultarse en [[wikitech:IP addresses]].

<div lang="en" dir="ltr" class="mw-content-ltr">
If you need to use a proxy to access the internet from behind the firewall, see  {{ll|Manual:$wgHTTPProxy|$wgHTTPProxy}}.
</div>

<span id="See_also"></span>
== Véase también ==
* {{ll|Manual:$wgForeignFileRepos}} &ndash; para tener la misma funcionalidad que InstantCommons pero descargando de otros wikis
* {{ll|PhotoCommons}} &ndash; Extensión para Wordpress que proporciona la misma funcionalidad
* [[Special:MyLanguage/Sites using InstantCommons|Ejemplos de sitios que utilizan InstantCommons]]
* [[Extension:QuickInstantCommons]]

<span id="References"></span>
== Referencias ==
<references />

[[Category:MediaWiki development{{#translation:}}]]