# Extensió MediaWiki de Gestió Monedes

`GestioMonedes` és l'extensió activa de MediaWiki del projecte `gestio_monedes`.

Permet treballar amb el catàleg de monedes directament des de la wiki mitjançant la pàgina especial `Especial:GestioMonedes`, sense haver de sortir de MediaWiki per consultar, filtrar o inserir dades.

## Capacitats principals

- lectura de monedes des de `MariaDB`
- lectura de monedes des de `CSV`
- lectura de monedes des de `XML`
- inserció de noves monedes a `MariaDB`, `CSV` o `XML`
- filtres per nom, país, any d'emissió i rang de valor
- filtre específic per mostrar només monedes amb imatge
- ordenació per nom, valor, any o darrera actualització
- límit configurable de resultats visibles
- visualització d'imatges amb resolució per URL, ruta local o placeholder

## Millores visuals i d'ús

La versió actual de l'extensió incorpora una interfície més cuidada i completa:

- capçalera introductòria amb resum del propòsit de la pàgina
- panell de resum amb font activa, nombre de resultats, fonts operatives i registres totals
- bloc de diagnòstic de fonts amb estat, lectura, escriptura i volum de dades
- filtres actius visibles en forma de pastilles
- selector d'ordenació i límit per controlar millor la consulta
- formulari d'inserció separat del formulari de consulta
- ajuda contextual al bloc d'inserció per explicar validació, imatges i comportament de CSV/XML
- targetes de resultat més compactes, amb valor destacat, país, any i identificador
- metadada d'última actualització a les targetes quan la font la proporciona
- estat buit específic quan no hi ha monedes o la cerca no retorna coincidències

## Estructura rellevant

- codi principal: `mediawiki-extension/GestioMonedes`
- pàgina especial: `includes/SpecialGestioMonedes.php`
- accés a dades: `includes/GestioMonedesSourceManager.php`
- estils públics: `modules/ext.gestiomonedes.styles.css`

## Configuració

L'extensió reutilitza la configuració privada del projecte:

- `/etc/gestio_monedes/config.local.php`

Carrega habitual dins de `LocalSettings.php`:

```php
wfLoadExtension( 'GestioMonedes' );
$wgGestioMonedesDefaultSource = 'mariadb';
```

## Ubicació i accés

- ruta del codi: `/var/www/html/gestio_monedes/mediawiki-extension/GestioMonedes`
- URL de la pàgina especial: `https://fmehmood.cat/mediawiki/index.php/Especial:GestioMonedes`

## Requisits coberts

L'extensió compleix els requisits de l'activitat perquè és capaç de:

- llegir informació de `MariaDB`, `CSV` i `XML`
- filtrar dades per criteris de cerca
- refinar visualitzacions amb ordenació, límit i filtre d'imatges
- mostrar imatges de les monedes
- introduir noves dades a la font seleccionada