Outillage/MediaWiki/Personnalisation - Historique des versions

Jordan : /* Implémentation */

2020-01-07T22:46:25Z

Implémentation

Jordan : /* Quelques variables */

2019-08-13T13:10:10Z

Quelques variables

Jordan : Jordan a déplacé la page MediaWiki/Personnalisation vers Outillage/MediaWiki/Personnalisation sans laisser de redirection

2019-06-06T12:22:06Z

Jordan a déplacé la page MediaWiki/Personnalisation vers Outillage/MediaWiki/Personnalisation sans laisser de redirection

Jordan : /* Quelques variables */

2019-06-06T10:00:03Z

Quelques variables

Jordan : Page créée avec « == Présentation == Cette page a pour objet de décrire la configuration personnalisée de ce MediaWiki. == Fichier LocalSettings.php == === Présentation === Le fichier... »

2019-06-06T09:58:33Z

Page créée avec « == Présentation == Cette page a pour objet de décrire la configuration personnalisée de ce MediaWiki. == Fichier LocalSettings.php == === Présentation === Le fichier... »

Nouvelle page

== Présentation ==
Cette page a pour objet de décrire la configuration personnalisée de ce MediaWiki.

== Fichier LocalSettings.php ==
=== Présentation ===
Le fichier LocalSettings.php offre les paramètres de configuration de base d'un MediaWiki (plus d'informations sur [https://www.mediawiki.org/wiki/Manual:LocalSettings.php/fr Manual:LocalSettings.php]).

Il est accessible en se connectant directement au serveur. Il se trouve à la racine du dossier hébergeant les fichiers du MediaWiki.

=== Quelques variables ===
Pour information, voici la liste de quelques variables implémentées :

Variables générales :
<syntaxhighlight lang="php">
$wgSitename = "Wiki de Jordan LE NUFF";
$wgMetaNamespace = "Wiki_de_Jordan_LE_NUFF";
$wgFavicon = "$wgScriptPath/images/favicon.png";
$wgScriptPath = "";
$wgArticlePath = "/$1";
$wgUsePathInfo = true;
$wgServer = "https://wiki.jordan-lenuff.com";
$wgResourceBasePath = $wgScriptPath;
$wgLogo = "$wgResourceBasePath/resources/assets/Logo_Jordan_LE-NUFF_200x200.png";
$wgEnableUploads = true;
$wgLanguageCode = "fr";
</syntaxhighlight>

Variables pour désactiver le cache du MediaWiki :
<syntaxhighlight lang="php">
$wgEnableParserCache = false;
$wgCachePages = false;
</syntaxhighlight>

Variables pour les skins :
<syntaxhighlight lang="php">
$wgDefaultSkin = "vector";
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Vector' );
</syntaxhighlight>

Variables pour charger les extensions :
<syntaxhighlight lang="php">
wfLoadExtension( 'CategoryTree' );
wfLoadExtension( 'Cite' );
wfLoadExtension( 'CodeEditor' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'PdfHandler' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'WikiEditor' );
wfLoadExtension( 'LabeledSectionTransclusion' );
wfLoadExtension( 'MsUpload' );
wfLoadExtension( 'VisualEditor' );
require_once "$IP/extensions/ClipUpload/ClipUpload.php";
</syntaxhighlight>

Variables pour se connecter à la base de données (valeurs volontairement cachées) :
<syntaxhighlight lang="php">
$wgDBtype = "XXXXXX";
$wgDBserver = "XXXXXX";
$wgDBname = "XXXXXX";
$wgDBuser = "XXXXXX";
$wgDBpassword = "XXXXXX";
$wgDBprefix = "XXXXXX";
$wgDBTableOptions = "XXXXXX";
</syntaxhighlight>

Variable pour l'utilisation de sous-pages :
<syntaxhighlight lang="php">
$wgNamespacesWithSubpages[NS_MAIN] = true;
</syntaxhighlight>


== Namespace ==
=== Présentation ===
Un espace de noms (namespace) est une collection de pages qui partagent un sujet similaire, par exemple des pages dont l'utilisation est la même. Dans le cas de ce MediaWiki, nous utilisons les namespaces pour compartimenter les sujets liés à des clients différents et nous appliquons une restriction d'accès en fonction des groupes d'appartenance des utilisateurs.

=== Implémentation ===
A ce jour, les namespaces suivants sont installés de cette façon dans le fichier LocalSettings.php :
<syntaxhighlight lang="php">
## Namespaces configuration
# Define constants for additional namespaces
#define("NS_ANAMESPACE", 3000);
#define("NS_OTHERNAMESPACE", 3100);
#define("NS_ANOTHERNAMESPACEAGAIN", 3200);

# Add personnal namespaces
#$wgExtraNamespaces[NS_ANAMESPACE] = "Un namespace";
#$wgExtraNamespaces[NS_OTHERNAMESPACE] = "Autre namespace";
#$wgExtraNamespaces[NS_ANOTHERNAMESPACEAGAIN] = "Encore un autre namespace";

# Enable subpages in the namespaces
$wgNamespacesWithSubpages[NS_MAIN] = true;
#$wgNamespacesWithSubpages[NS_ANAMESPACE] = true;
#$wgNamespacesWithSubpages[NS_OTHERNAMESPACE] = true;
#$wgNamespacesWithSubpages[NS_ANOTHERNAMESPACEAGAIN] = true;

## End of Namespaces configuration
</syntaxhighlight>

== Groupes Active Directory ==
=== Présentation ===
Afin d'avoir une meilleure maîtrise des accès aux différentes ressources informatiques de l'entreprise, la création de certains groupes a été nécessaire dans l'Active Directory.

=== Méthode ===
Afin de faciliter l'administration des groupes dans l'Active Directory, il est recommandé d'appliquer [https://en.wikipedia.org/wiki/AGDLP la méthode AGDLP] dans la gestion des droits d'accès aux ressources.

=== Implémentation ===
Ainsi, tels que définis par la variable '''$wgLDAPRequiredGroups''' décrite dans la section Paramétrage de l'extension [[LDAP Authentication Plugin]], seuls les groupes suivants sont autorisés à se connecter au MediaWiki :

*MyGroup

== Gestion des droits d'accès ==
=== Présentation ===
Une fois la restriction d'accès générale mise en place au travers de la variable '''$wgLDAPRequiredGroups''', il est possible d'affiner les droits selon les groupes.

=== Implémentation ===
La configuration des droits d'accès se fait dans le fichier LocalSettings.php. La configuration actuelle est la suivante :
<syntaxhighlight lang="php">
## Permissions configuration
# Création des groupes de l'Active Directory sur la base des groupes existants
$wgGroupPermissions['MyGroup'] = array_merge(
$wgGroupPermissions['sysop'],
$wgGroupPermissions['interface-admin'],
$wgGroupPermissions['user'],
);
#$wgGroupPermissions['Groupe_AD_de_simples_utilisateurs_du_Wiki'] = $wgGroupPermissions['user'];

# Affinage des droits
#$wgGroupPermissions['Groupe_AD_de_simples_utilisateurs_du_Wiki']['move'] = false;
#$wgGroupPermissions['Groupe_AD_de_simples_utilisateurs_du_Wiki']['move-subpages'] = false;
#$wgGroupPermissions['Groupe_AD_de_simples_utilisateurs_du_Wiki']['move-rootuserpages'] = false;
#$wgGroupPermissions['Groupe_AD_de_simples_utilisateurs_du_Wiki']['move-categorypages'] = false;
#$wgGroupPermissions['Groupe_AD_de_simples_utilisateurs_du_Wiki']['movefile'] = false;
$wgGroupPermissions['*']['autocreateaccount'] = true;
$wgGroupPermissions['*']['createaccount'] = false;
$wgGroupPermissions['*']['read'] = false;
$wgGroupPermissions['*']['edit'] = false;
$wgGroupPermissions['*']['createpage'] = false;
$wgGroupPermissions['*']['createtalk'] = false;
$wgGroupPermissions['*']['writeapi'] = false;
$wgGroupPermissions['*']['editmyusercss'] = false;
$wgGroupPermissions['*']['editmyuserjs'] = false;
$wgGroupPermissions['*']['viewmywatchlist'] = false;
$wgGroupPermissions['*']['editmywatchlist'] = false;
$wgGroupPermissions['*']['viewmyprivateinfo'] = false;
$wgGroupPermissions['*']['editmyprivateinfo'] = false;
$wgGroupPermissions['*']['editmyoptions'] = false;

# Trick to VisualEditor 401 error
if ( !isset( $_SERVER['REMOTE_ADDR'] ) OR $_SERVER['REMOTE_ADDR'] == '127.0.0.1' OR $_SERVER['REMOTE_ADDR'] == 'localhost' OR $_SERVER['REMOTE_ADDR'] == 'monnomdeserveur') {
$wgGroupPermissions['*']['read'] = true;
$wgGroupPermissions['*']['edit'] = true;
}

# Filtrage pour l'extension Lockdown
$wgNamespacePermissionLockdown[NS_ANAMESPACE]['*'] = [ 'MyGroup' ];
#$wgNamespacePermissionLockdown[NS_OTHERNAMESPACE]['*'] = [ 'Un_groupe_AD_de_users' ];
#$wgNamespacePermissionLockdown[NS_ANOTHERNAMESPACEAGAIN]['*'] = [ 'Un_autre_groupe_AD_de_users' ];

# Suppression des groupes inutiles
unset( $wgGroupPermissions['user'] );
unset( $wgRevokePermissions['user'] );
unset( $wgAddGroups['user'] );
unset( $wgRemoveGroups['user'] );
unset( $wgGroupsAddToSelf['user'] );
unset( $wgGroupsRemoveFromSelf['user'] );
unset( $wgGroupPermissions['autoconfirmed'] );
unset( $wgRevokePermissions['autoconfirmed'] );
unset( $wgAddGroups['autoconfirmed'] );
unset( $wgRemoveGroups['autoconfirmed'] );
unset( $wgGroupsAddToSelf['autoconfirmed'] );
unset( $wgGroupsRemoveFromSelf['autoconfirmed'] );
unset( $wgGroupPermissions['bot'] );
unset( $wgRevokePermissions['bot'] );
unset( $wgAddGroups['bot'] );
unset( $wgRemoveGroups['bot'] );
unset( $wgGroupsAddToSelf['bot'] );
unset( $wgGroupsRemoveFromSelf['bot'] );
unset( $wgGroupPermissions['sysop'] );
unset( $wgRevokePermissions['sysop'] );
unset( $wgAddGroups['sysop'] );
unset( $wgRemoveGroups['sysop'] );
unset( $wgGroupsAddToSelf['sysop'] );
unset( $wgGroupsRemoveFromSelf['sysop'] );
unset( $wgGroupPermissions['bureaucrat'] );
unset( $wgRevokePermissions['bureaucrat'] );
unset( $wgAddGroups['bureaucrat'] );
unset( $wgRemoveGroups['bureaucrat'] );
unset( $wgGroupsAddToSelf['bureaucrat'] );
unset( $wgGroupsRemoveFromSelf['bureaucrat'] );

## End of permissions configuration
</syntaxhighlight>

== Charte graphique ==
=== Présentation ===
Il est possible de personnaliser l'apparence du MediaWiki. Cela se fait au travers de pages de code CSS (plus d'informations sur [https://www.mediawiki.org/wiki/Manual:CSS/fr Manuel:CSS]).

=== Implémentation ===
A ce jour, les personnalisations d'apparence du MediaWiki se trouve dans les pages suivantes :

[[MediaWiki:Common.css]]

Pour modifier une personnalisation d'apparence, il suffit simplement de modifier le code CSS de la page en question.

== Titre des sous-pages ==
=== Présentation ===
En temps normal, l'activation des sous-pages via la variable '''$wgNamespacesWithSubpages''' donne des titres de pages reprenant l'arborescence de la page. Ainsi, la sous-page accessible à l'adresse https://wiki.jordan-lenuff.com/Technique/Stockage/Hitachi (par exemple) se nommerait donc ''Technique/Stockage/Hitachi'', ce qui est moins convivial que simplement ''Hitachi''.

=== Implémentation ===
Afin d'obtenir un titre de sous-page convivial, il est nécessaire de modifier un fichier de la skin utilisée par le MediaWiki.

Dans la cas de ce MediaWiki, la skin utilisée est '''Vector'''. Il faut donc modifier le fichier '''skins/Vector/includes/VectorTemplate.php'''.

Le titre d'une page est identifié par un id et/ou une classe nommé '''firstHeading'''. Une fois cette occurrence trouvée dans le fichier template de la skin Vector, il faut remplacer la ligne <code>$this->get( 'title' )</code> (ligne 85) par <code>$this->getSkin()->getTitle()->getSubpageText()</code>.

Cela donne au final :
<syntaxhighlight lang="php" line start=76>
// Loose comparison with '!=' is intentional, to catch null and false too, but not '0'
if ( $this->data['title'] != '' ) {
echo Html::rawElement( 'h1',
[
'id' => 'firstHeading',
'class' => 'firstHeading',
'lang' => $this->get( 'pageLanguage' ),
],
// Raw HTML
//$this->get( 'title' )
$this->getSkin()->getTitle()->getSubpageText()
);
}
</syntaxhighlight>

@@ Ligne 292 : / Ligne 292 : @@
 Afin d'obtenir un titre de sous-page convivial, il est nécessaire de modifier un fichier de la skin utilisée par le MediaWiki.
-Dans la cas de ce MediaWiki, la skin utilisée est '''Vector'''. Il faut donc modifier le fichier '''skins/Vector/includes/VectorTemplate.php'''.
+Dans la cas de ce MediaWiki, la skin utilisée est '''Vector'''. Il faut donc modifier le fichier <code>skins/Vector/includes/VectorTemplate.php</code>.
 Le titre d'une page est identifié par un id et/ou une classe nommé '''firstHeading'''. Une fois cette occurrence trouvée dans le fichier template de la skin Vector, il faut remplacer la ligne <code>$this->get( 'title' )</code> (ligne 85) par <code>$this->getSkin()->getTitle()->getSubpageText()</code>.
@@ Ligne 311 : / Ligne 312 : @@
          );
+}
 </syntaxhighlight>

@@ Ligne 112 : / Ligne 112 : @@
 </syntaxhighlight>
 -->
 == Namespace ==

@@ Ligne 15 : / Ligne 15 : @@
 $wgSitename = "Wiki de Jordan LE NUFF";
 $wgMetaNamespace = "Wiki_de_Jordan_LE_NUFF";
-$wgFavicon = "$wgScriptPath/images/favicon.png";
+$wgFavicon = "/images/favicon.png";
 $wgScriptPath = "";
 $wgArticlePath = "/$1";
@@ Ligne 112 : / Ligne 112 : @@
 </syntaxhighlight>
 -->
 == Namespace ==
 === Présentation ===