Editing Documentation (section)

== LocalSettings Configuration (MediaWiki) ==
The <code>LocalSettings.php</code> file is the backbone of the UNITApedia Impact Observatory’s MediaWiki installation. It drives everything from site identity to extensions, external data sources, caching, security and beyond. Below is an overview of how your current configuration supports the site’s functionality.

=== Basic Site Configuration ===
==== Site Identity & URLs ====
* <code>$wgSitename</code>: Set via the <q>OBSERVATORY_NAME</q> environment variable.  
* <code>$wgServer</code> &amp; <code>$wgCanonicalServer</code>: Use <code>https://</code> + <code>DOMAIN_NAME</code> from env.  
* <code>$wgScriptPath</code>: Set to <code>""</code>, so all URLs are relative to the webroot.  
* <code>$wgResourceBasePath</code>: Mirrors <code>$wgScriptPath</code> for static assets.  

==== Locales & Protocols ====
* Default language is English (<code>$wgLanguageCode = "en"</code>).  
* Shell locale forced to <code>C.UTF-8</code> for consistent sorting/formatting.  
* Raw HTML is enabled (<code>$wgRawHtml = true</code>) and an extra allowed protocol was added (<code>https://elearn.univ-pau.fr/</code>).  

=== User Preferences & Authentication ===
==== Email & Notifications ====
* Email is fully enabled (<code>$wgEnableEmail</code>, <code>$wgEnableUserEmail</code>, <code>$wgEmailAuthentication</code>).  
* Sender address and emergency contact are pulled from env (<code>MEDIAWIKI_PWD_EMAIL</code>, <code>MEDIAWIKI_CONTACT_EMAIL</code>).  

==== Login Options ====
* Local login via [https://www.mediawiki.org/wiki/Extension:PluggableAuth PluggableAuth] is enabled (<code>$wgPluggableAuth_EnableLocalLogin = true</code>).  
* Keycloak/[https://www.mediawiki.org/wiki/Extension:OpenID_Connect OpenID Connect] example remains commented out for future SSO.  

=== Database Settings ===
==== Primary Database (MySQL/MariaDB) ====
* Type: <code>mysql</code> on host <code>mariadb</code>.  
* Credentials and database name injected from <q>MEDIAWIKI_DB_</q> env vars.  
* Table options: InnoDB with binary charset.  

=== Caching, File Uploads & Image Handling ===
==== Uploads & Commons ====
* File uploads are enabled (<code>$wgEnableUploads = true</code>).  
* InstantCommons integration is turned on (<code>$wgUseInstantCommons = true</code>).  
* ImageMagick is used for conversions (<code>$wgUseImageMagick = true</code>, convert command at <code>/usr/bin/convert</code>).  

==== File Types & Security ====
* A broad list of extensions is allowed: png, gif, jpg, doc, xls, pdf, pptx, svg, etc.  
* A MIME-type blacklist protects against script uploads (e.g. PHP, shell scripts, MS executables).  

=== Localization & Time Zone ===
* Wiki text in English; PHP shell locale <code>C.UTF-8</code>.  
* <q>Time Zone</q>: <code>$wgLocaltimezone</code> set to <code>UTC</code>, and <code>date_default_timezone_set('UTC')</code> for consistency.  

=== Security & HTTPS ===
* <q>Secret & Upgrade Keys</q>: <code>$wgSecretKey</code> and <code>$wgUpgradeKey</code> loaded from env vars.  
* <q>HTTPS Enforcement</q>: All traffic is forced over HTTPS (<code>$wgForceHTTPS = true</code>).  

=== Skins, Permissions & User Groups ===
==== Skinning ====
* Default skin is Vector-2022 (<code>$wgDefaultSkin = 'vector-2022'</code>), with older Vector-2011 disabled.  
* All users are locked onto Vector-2022 (<code>$wgVectorDefaultSkinVersion = '2'</code>, <code>$wgVectorShowSkinPreferences = false</code>).  

==== User Rights ====
* Anonymous (<q>*</q>) users can read and edit pages but cannot create accounts.  
* Registered <q>user</q> role loses self-edit rights (CSS/JS/JSON).  
* <q>sysop</q> and custom roles (e.g. translator, recipes) have fine-grained SMW and Page Forms permissions.  

=== Enabled Extensions ===
A streamlined but powerful set of extensions is loaded via <code>wfLoadExtension()</code>:
<div style="column-count:4; -moz-column-count:4; -webkit-column-count:4;">
* [https://www.mediawiki.org/wiki/Extension:Arrays Arrays]  
* [https://www.mediawiki.org/wiki/Extension:Babel Babel]  
* [https://www.mediawiki.org/wiki/Extension:CategoryTree CategoryTree]  
* [https://www.mediawiki.org/wiki/Extension:Cargo Cargo]  
* [https://www.mediawiki.org/wiki/Extension:Cite Cite]  
* [https://www.mediawiki.org/wiki/Extension:CleanChanges CleanChanges]  
* [https://www.mediawiki.org/wiki/Extension:CodeEditor CodeEditor/CodeMirror]  
* [https://www.mediawiki.org/wiki/Extension:ConfirmEdit ConfirmEdit]  
* [https://www.mediawiki.org/wiki/Extension:DataTransfer DataTransfer]  
* [https://www.mediawiki.org/wiki/Extension:External_Data External Data]  
* [https://www.mediawiki.org/wiki/Extension:ECharts ECharts]  
* [https://www.mediawiki.org/wiki/Extension:FlexDiagrams FlexDiagrams]  
* [https://www.mediawiki.org/wiki/Extension:Gadgets Gadgets]  
* [https://www.mediawiki.org/wiki/Extension:HeaderTabs HeaderTabs]  
* [https://www.mediawiki.org/wiki/Extension:IframePage IframePage]  
* [https://www.mediawiki.org/wiki/Extension:ImageMap ImageMap]  
* [https://www.mediawiki.org/wiki/Extension:InputBox InputBox]  
* [https://www.mediawiki.org/wiki/Extension:Interwiki Interwiki]  
* [https://www.mediawiki.org/wiki/Extension:MagicNoCache MagicNoCache]  
* [https://www.mediawiki.org/wiki/Extension:Maps Maps]  
* [https://www.mediawiki.org/wiki/Extension:Math Math]  
* [https://www.mediawiki.org/wiki/Extension:ModernTimeline ModernTimeline]  
* [https://www.mediawiki.org/wiki/Extension:MultimediaViewer MultimediaViewer]  
* [https://www.mediawiki.org/wiki/Extension:Network Network]  
* [https://www.mediawiki.org/wiki/Extension:Nuke Nuke]  
* [https://www.mediawiki.org/wiki/Extension:Page_Forms Page Forms]  
* [https://www.mediawiki.org/wiki/Extension:PageImages PageImages]  
* [https://www.mediawiki.org/wiki/Extension:Page_Schemas PageSchemas]  
* [https://www.mediawiki.org/wiki/Extension:ParserFunctions ParserFunctions]  
* [https://www.mediawiki.org/wiki/Extension:PdfHandler PdfHandler]  
* [https://www.mediawiki.org/wiki/Extension:PluggableAuth PluggableAuth]  
* [https://www.mediawiki.org/wiki/Extension:Poem Poem]  
* [https://www.mediawiki.org/wiki/Extension:Renameuser Renameuser]  
* [https://www.mediawiki.org/wiki/Extension:ReplaceText ReplaceText]  
* [https://www.mediawiki.org/wiki/Extension:SecureLinkFixer SecureLinkFixer]  
* [https://www.mediawiki.org/wiki/Extension:Scribunto Scribunto]  
* [https://www.mediawiki.org/wiki/Extension:SpamBlacklist SpamBlacklist]  
* [https://www.mediawiki.org/wiki/Extension:SyntaxHighlight_GeSHi SyntaxHighlight_GeSHi]  
* [https://www.mediawiki.org/wiki/Extension:TabberNeue TabberNeue]  
* [https://www.mediawiki.org/wiki/Extension:TemplateData TemplateData]  
* [https://www.mediawiki.org/wiki/Extension:TemplateWizard TemplateWizard]  
* [https://www.mediawiki.org/wiki/Extension:TextExtracts TextExtracts]  
* [https://www.mediawiki.org/wiki/Extension:TitleBlacklist TitleBlacklist]  
* [https://www.mediawiki.org/wiki/Extension:Translate Translate]  
* [https://www.mediawiki.org/wiki/Extension:TreeAndMenu TreeAndMenu]  
* [https://www.mediawiki.org/wiki/Extension:UniversalLanguageSelector UniversalLanguageSelector]  
* [https://www.mediawiki.org/wiki/Extension:Variables Variables]  
* [https://www.mediawiki.org/wiki/Extension:VisualEditor VisualEditor]  
* [https://www.mediawiki.org/wiki/Extension:Widgets Widgets]  
* [https://www.mediawiki.org/wiki/Extension:WikiEditor WikiEditor]  
</div>

==== Mapping & Charts ====
* [https://www.mediawiki.org/wiki/Extension:ECharts ECharts] for rich, JS-driven charts.  
* [https://www.mediawiki.org/wiki/Extension:OpenStreetMap_OpenLayers_OpenStreetMap OpenStreetMap] for coordinate-based maps.  

=== Semantic MediaWiki Stack ===
* <code>wfLoadExtension('SemanticMediaWiki')</code> and <code>enableSemantics(getenv('DOMAIN_NAME'))</code>.  
* SMW add-ons: [https://www.mediawiki.org/wiki/Extension:SemanticResultFormats SemanticResultFormats], [https://www.mediawiki.org/wiki/Extension:SemanticCompoundQueries SemanticCompoundQueries], [https://www.mediawiki.org/wiki/Extension:SemanticFormsSelect SemanticFormsSelect].  
* Semantic links enabled in the <q>DATASRC</q> namespace.  

=== External Data Sources & Query Files ===
* <q>Local file source DDD</q> pointing at <code>/home/hub/data/files/dev/</code>.  
* [https://unitapedia.univ-unita.eu/pga/ PostgreSQL] source ID for live lookups.  
* GET-allowance turned on (<code>$wgExternalDataAllowGetters = true</code>).  
* Custom query includes: <code>query_meta_unita.php</code>, <code>query_meta_indicators.php</code>, <code>query_raw.php</code>, <code>query_count.php</code>, <code>query_DEMO_DEC24.php</code>, <code>query_DEMO_JAN25.php</code>, and an <code>indicators.php</code> aggregator.  

=== Custom Namespaces ===
* <q>Doc</q> (<code>800/801</code>) and <q>DataSrc</q> (<code>810/811</code>) namespaces defined for structured separation of docs vs. ingested data.  
* A <q>Recipes</q> (<code>805/806</code>) namespace for specialized content.  

=== Mail & Logging ===
* <q>SMTP</q>: Local Postfix on <code>localhost:25</code>, no auth, unencrypted.  
* Mail debug logs written to <code>/tmp/mediawiki-mail.log</code>.  

=== Debugging & Development ===
* <q>Error Display</q>: All exception details, backtraces, SQL errors, and development warnings are enabled (<code>$wgShowExceptionDetails = true</code>, <code>$wgShowDebug = true</code>, etc.) for rapid troubleshooting.