Extension:SocialProfile
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 dossierextensions/
. - 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'utilisateurawards/
— Les images des cadeaux système (récompenses) et des cadeaux normaux seront stockées ici- Déplacez le répertoire
awards/
deextensions/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
deextensions/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éesuser_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'sMediaWiki:Vector.css
or equivalentMediaWiki:<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
Captures d'écran
- Extension:SocialProfile/Screenshots - captures d'écran de l'extension et quelques descriptions très courtes des caractéristiques.
Cette extension est incluse dans les fermes de wikis ou les hôtes suivants et / ou les paquets : Cette liste ne fait pas autorité. Certaines fermes de wikis ou hôtes et / ou paquets peuvent contenir cette extension même s'ils ne sont pas listés ici. Vérifiez toujours cela avec votre ferme de wikis ou votre hôte ou votre paquet avant de confirmer. |