Extension:SocialProfile

Manuel des extensions MediaWiki

Social Profile État de la version : stable
Implémentation	Page spéciale , Base de données , Ajax
Description	Intègre plusieurs fonctionnalités sociales dans MediaWiki pour les communautés
Auteur(s)	Aaron Wright Adam Carter David Pean Jack Phoenix
Dernière version	1.14 (mises à jour continues (voir compatibilité de MediaWiki (see MediaWiki compatibility))
MediaWiki	1.39+
Modifie la base de données	Oui
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code Template:WikimediaDownload/gerritonly
Exemple	Brickipedia, the LEGO Wiki
Paramètres $wgUserPageChoice $wgUpdateProfileInRecentChanges $wgUploadAvatarInRecentChanges $wgUserProfileDisplay $wgUserProfileThresholds $wgUserLevels $wgNamespacesForEditPoints $wgUserStatsPointValues
Droits ajoutés avatarremove awardsmanage editothersprofiles giftadmin updatepoints userboard-delete
Accroches utilisées BeforePageDisplay CanonicalNamespaces LoadExtensionSchemaUpdates BeforeCreateEchoEvent EchoGetDefaultNotifiedUsers EchoGetBundleRules ParserFirstCallInit DifferenceEngineShowDiff DifferenceEngineShowDiffPage DifferenceEngineOldHeader DifferenceEngineNewHeader OutputPageBodyAttributes
Accroches fournies UserProfileBeginLeft UserProfileEndLeft UserProfileBeginRight UserProfileRightSideAfterActivity UserProfileEndRight UserProfileGetProfileHeaderLinks SpecialUpdateProfile::saveSettings_pref BasicProfileChanged PersonalInterestsChanged SpecialUpdateProfile::displayPreferencesForm NewAvatarUploaded NewFriendAccepted NewFoeAccepted RelationshipRemovedByUserID
Téléchargements trimestriels	68 (Ranked 75th)
Traduire l’extension SocialProfile sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension de SocialProfile intègre un profil social, un tableau d'utilisateurs et des informations de base sur le profil dans MediaWiki, en particulier les avatars, les amitiés, les ennemis, le tableau utilisateur, le tableau de bord, le système de classement de niveaux utilisateur, les récompenses et les cadeaux. Le paquet informe également les utilisateurs par courriel lorsque d'autres utilisateurs les demandent en tant qu'amis ou ennemis et/ou leur envoie un message.

• Pour la documentation technique (si vous êtes administrateur système), voir Extension:SocialProfile/Technical documentation .
• Pour l'information développeur, voir Extension:SocialProfile/Developer information .
• Pour l'aide à l'utilisation de SocialProfile, voir Help:Extension:SocialProfile .

Installer

• Si vous utilisez le ExtensionDistributor pour télécharger SocialProfile, assurez-vous de sélectionner la dernière version de développement master(latest development version); les versions plus anciennes contiennent beaucoup de bogues et elles ne sont pas maintenues, tandis que master est toujours à jour et contient les dernières fonctionnalités et les correctifs des bogues ! Voir la politique de compatibilité MediaWiki des outils sociaux pour plus d'informations.
• Vous pouvez aussi utiliser Git ainsi :

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SocialProfile

• Copiez la branche master et placez le(s) fichier(s) dans un répertoire appelé SocialProfile dans votre dossier extensions/.
• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  require_once "$IP/extensions/SocialProfile/SocialProfile.php";
  

• Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
• Les répertoires suivants doivent exister sous $wgUploadDirectory du wiki :
  • avatars/ — Répertoire où sont stockées toutes les images d'avatar téléversées par l'utilisateur
  • awards/ — Les images des cadeaux système (récompenses) et des cadeaux normaux seront stockées ici
  • Déplacez le répertoire awards/ de extensions/SocialProfile vers le répertoire d'images utilisé dans votre installation MediaWiki. Ce répertoire doit être accessible en écriture. Les images incluses dans ce dossier par défaut peuvent être utilisées pour les récompenses si vous les téléversez via Special:SystemGiftManagerLogo, mais elles ne seront pas affichées par défaut à la manière des images par défaut des avatars.
  • Déplacez le répertoire avatars de extensions/SocialProfile vers le répertoire d'images utilisé dans votre installation MediaWiki. Ce répertoire doit être accessible en écriture.
•  Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Fonctions d'analyseur syntaxique

• {{#avatar:Username}} - récupère l'image de l'avatar pour l'utilisateur spécifié.
• {{#randomuserswithavatars}}
• {{#newusers}}

Options utilisateur

• echo-subscriptions-web-social-rel (nécessite que l'extension Echo soit installée)
• echo-subscriptions-email-social-rel (nécessite que l'extension Echo soit installée)

Paramètres de configuration

$wgUserProfileDisplay['board'] = true;
$wgUserProfileDisplay['foes'] = true;
$wgUserProfileDisplay['friends'] = true;
$wgUserProfileDisplay['avatar'] = true; // Si la valeur est initialisée à <code>false</code>, il désactive à la fois l'affichage et le téléversement de l'avatar
$wgUserBoard = true;
$wgFriendingEnabled = true;
$wgAvatarKey = $wgDBname;
$wgUserPageChoice = true;
$wgUserProfileAvatarsInDiffs = true;

Il existe d'autres variables de configuration introduites dans une mise à jour ultérieure pour les wikis qui utilisent une solution de stockage externe pour leurs images (comme Amazon S3 ou Swift). On doit indiquer explicitement à SocialProfile d'utiliser ce stockage externe pour les avatars, etc., ou bien il les téléversera sur le serveur local de toute façon.

Par exemple, lors de l'utilisation de S3, vous devez indiquer explicitement le serveur à S3, la confidentialité du fichier pour le public et le chemin du fichier pour les avatars :

$wgSocialProfileFileBackend = 'AmazonS3';
$wgAWSRepoZones['avatars'] = [
 'container' => 'avatars',
 'path' => "/avatars",
 'isPublic' => true
];

Remarques

• Mise à jour - Si vous mettez à niveau à partir de la version 1.2 ou supérieure de SocialProfile, vous devrez créer quatre nouvelles tables de base de données manuellement: gift, system_gift, user_gift, user_system_gift. Si vous mettez à jour à partir de la v 1.3, vous devrez créer la table de base de données user_system_messages.
• Depuis r93317, les espaces de noms de SocialProfile sont automatiquement enregistrés, donc vous n'avez pas besoin de les ajouter à $wgExtraNamespaces .
• SocialProfile utilise soit ImageMagick ou la bibliothèque GD intégrée de PHP (à partir de r93067), selon ce qui est disponible, pour créer le fichier image redimensionné de l'avatar, la récompense ou du cadeau.
• Newer version of the Vector skin ("Vector-2022", informally also "new Vector") and some other inconsistent skins "no longer" support the visualClear CSS class, thus causing the social user profile pages to render incorrectly. Fixing it locally should be as simple as adding this to your wiki's MediaWiki:Vector.css or equivalent MediaWiki:<skinname>.css page:

  /*  visualClear CSS class definition for [[mw:Extension:SocialProfile]]
      because Vector does not include the definition anymore; see
      https://phabricator.wikimedia.org/T328235 and 
      https://phabricator.wikimedia.org/T287962 */
  .visualClear {
  	clear: both;
  }
  

  • See also phab:T328235 and e.g. phab:T287962.

Rapporter les bogues

• Social tools/Contributing and reporting bugs

Captures d'écran

• Extension:SocialProfile/Screenshots - captures d'écran de l'extension et quelques descriptions très courtes des caractéristiques.