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

Social Profile Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Speciální stránka Category:Special page extensions/cs, Databáze Category:Database extensions/cs, AjaxCategory:Ajax extensions/cs
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+Category:Extensions with manual MediaWiki version
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/gerritonlyCategory:Extensions in Wikimedia version control/cs
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 Category:Extensions which add rights/cs
Použité háčky (hooks) BeforePageDisplay Category:BeforePageDisplay extensions/cs CanonicalNamespaces Category:CanonicalNamespaces extensions/cs LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions/cs BeforeCreateEchoEvent Category:BeforeCreateEchoEvent extensions/cs EchoGetDefaultNotifiedUsers Category:EchoGetDefaultNotifiedUsers extensions/cs EchoGetBundleRules Category:EchoGetBundleRules extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs DifferenceEngineShowDiff Category:DifferenceEngineShowDiff extensions/cs DifferenceEngineShowDiffPage Category:DifferenceEngineShowDiffPage extensions/cs DifferenceEngineOldHeader Category:DifferenceEngineOldHeader extensions/cs DifferenceEngineNewHeader Category:DifferenceEngineNewHeader extensions/cs OutputPageBodyAttributes Category:OutputPageBodyAttributes extensions/cs
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

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.Category:Extensions not using extension registration/cs

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í.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Canasta Category:Extensions included in Canasta/cs Miraheze Category:Extensions included in Miraheze/cs MyWikisCategory:Extensions included in MyWikis/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.