Rozšíření:SocialProfile

Příručka k rozšířením MediaWiki

Social Profile Stav rozšíření: stabilní
Implementace	Speciální stránka , Databáze , Ajax
Popis	Začleňuje více sociálních funkcí do MediaWiki pro komunity
Autoři	Aaron Wright Adam Carter David Pean Jack Phoenix
Nejnovější verze	1.14 (Průběžně aktualizováno (viz kompatibilita MediaWiki))
MediaWiki	1.43+
Změny v databázi	Ano
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Template:WikimediaDownload/gerritonly
Příklad	Brickipedia, the LEGO Wiki
Parametry $wgUserPageChoice $wgUpdateProfileInRecentChanges $wgUploadAvatarInRecentChanges $wgUserProfileDisplay $wgUserProfileThresholds $wgUserLevels $wgNamespacesForEditPoints $wgUserStatsPointValues
Přidaná práva avatarremove awardsmanage editothersprofiles giftadmin updatepoints userboard-delete
Použité háčky (hooks) BeforePageDisplay CanonicalNamespaces LoadExtensionSchemaUpdates BeforeCreateEchoEvent EchoGetDefaultNotifiedUsers EchoGetBundleRules ParserFirstCallInit DifferenceEngineShowDiff DifferenceEngineShowDiffPage DifferenceEngineOldHeader DifferenceEngineNewHeader OutputPageBodyAttributes
Poskytované háčky (hooks) UserProfileBeginLeft UserProfileEndLeft UserProfileBeginRight UserProfileRightSideAfterActivity UserProfileEndRight UserProfileGetProfileHeaderLinks SpecialUpdateProfile::saveSettings_pref BasicProfileChanged PersonalInterestsChanged SpecialUpdateProfile::displayPreferencesForm NewAvatarUploaded NewFriendAccepted NewFoeAccepted RelationshipRemovedByUserID
Čtvrtletní stahování	51 (Ranked 67th)
Přeložte rozšíření SocialProfile, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření SocialProfile zahrnuje sociální profil, uživatelskou nástěnku a základní profilové informace do MediaWiki, konkrétně avatary, spřátelení, nepřátelství, uživatelskou desku, nábor, systém hodnocení uživatelských úrovní, ocenění a dárky. Balíček také upozorní uživatele e-mailem, když je ostatní uživatelé požádají jako přítele nebo nepřítele a nebo jim pošle zprávu.

• Pro technickou dokumentaci (pokud jste správce systému) viz Extension:SocialProfile/Technical documentation .
• Pro informace pro vývojáře viz Extension:SocialProfile/Developer information .
• Pro nápovědu k používání SocialProfile viz Help:Extension:SocialProfile .

Instalace

• Pokud ke stažení SocialProfile používáte ExtensionDistributor, ujistěte se, že jste vybrali "master (nejnovější vývojová verze)". U starších verzí je zaručeno, že obsahují spoustu chyb a jsou neudržované, zatímco master je vždy aktuální a obsahuje nejnovější funkce a opravy chyb! Další informace naleznete v zásadách kompatibility MediaWiki sociálních nástrojů.
• Můžete také použít Git, například:

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

• Stáhněte si hlavní větev soubor/y a vložte je do adresáře pojmenovaného SocialProfile ve vaší složce extensions/.
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

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

• Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
• Následující adresáře by měly existovat pod $wgUploadDirectory wiki:
  • avatars/ — adresář, kde jsou uloženy všechny uživatelem nahrané obrázky avatarů
  • awards/ — zde budou uloženy systémové dárky (ocenění) a normální obrázky dárků
  • Přesuňte adresář awards/ z extensions/SocialProfile do adresáře obrázků, který se používá ve vaší instalaci MediaWiki. Tento adresář by měl být zapisovatelný. Obrázky obsažené v této složce ve výchozím nastavení lze použít pro ocenění, pokud je nahrajete prostřednictvím Special:SystemGiftManagerLogo, ale nebudou se zobrazovat jako "výchozí" stejným způsobem, jakým se zobrazují výchozí obrázky avatarů.
  • Přesuňte adresář avatars z extensions/SocialProfile do adresáře obrázků použitého ve vaší instalaci MediaWiki. Tento adresář by měl být zapisovatelný.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Funkce parseru

• {{#avatar:Username}} - načte obrázek avatara pro zadaného uživatele.
• {{#randomuserswithavatars}}
• {{#newusers}}

Možnosti uživatele

• echo-subscriptions-web-social-rel (vyžaduje nainstalované rozšíření Echo)
• echo-subscriptions-email-social-rel (vyžaduje nainstalované rozšíření Echo)

Konfigurační proměnné

$wgUserProfileDisplay['board'] = true;
$wgUserProfileDisplay['foes'] = true;
$wgUserProfileDisplay['friends'] = true;
$wgUserProfileDisplay['avatar'] = true; // Pokud je nastaveno na hodnotu false, deaktivuje zobrazení avatarů i nahrávání
$wgUserBoard = true;
$wgFriendingEnabled = true;
$wgAvatarKey = $wgDBname;
$wgUserPageChoice = true;
$wgUserProfileAvatarsInDiffs = true;

V pozdější aktualizaci jsou uvedeny některé další konfigurační proměnné pro wikiny, které pro své obrázky používají řešení externího úložiště (například Amazon S3 nebo Swift). SocialProfile musí být výslovně řečeno, aby používal toto externí úložiště pro avatary atd., nebo je stejně nahraje na místní server.

Například, když používáte S3, musíte explicitně nastavit backend na S3, soukromí souboru na veřejné a cestu k souboru pro avatary:

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

Poznámky

• Aktualizace - pokud aktualizujete z SocialProfile verze 1.2 nebo starší, budete muset ručně vytvořit čtyři nové databázové tabulky: gift, system_gift, user_gift, user_system_gift. Pokud aktualizujete z verze 1.3, budete muset vytvořit tabulku databáze user_system_messages.
• Od r93317 jsou jmenné prostory SocialProfile automaticky registrovány, takže je nemusíte přidávat do $wgExtraNamespaces .
• SocialProfile používá buď ImageMagick , nebo PHP vestavěnou GD knihovnu (od r93067), v závislosti na tom, která je k dispozici, pro vytváření souborů avatarů, ocenění a dárků se změněnou velikostí.
• 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. Lokální oprava by měla být stejně jednoduchá jako přidání na stránku vaší wiki MediaWiki:Vector.css nebo ekvivalent MediaWiki:<skinname>.css:

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

  • Viz také phab:T328235 a např. phab:T287962.

Hlášení chyb

• Social tools/Contributing and reporting bugs

Snímky obrazovky

• Extension:SocialProfile/Screenshots - pro snímky obrazovky rozšíření a několik velmi stručných popisů funkcí.