README

This is the readme file for SocialProfile extension.

==Intro==
SocialProfile extension adds social networking features, such as friending
and user-to-user messages into your MediaWiki. These are not the only
features that SocialProfile has to offer - for a complete feature listing
and up-to-date documentation about installing and using the software,
please see the extension's infopage on MediaWiki.org:

https://www.mediawiki.org/wiki/Extension:SocialProfile

==Authors==
SocialProfile was written by David Pean and Aaron Wright for Wikia, Inc.

It has been maintained by Jack Phoenix <jack@countervandalism.net> since 2008.

==License==
SocialProfile is licensed under GNU General Public License 2.0 or later.
See http://www.gnu.org/copyleft/gpl.html for more details.

==Bugs==
Bugs and issues should be reported on the MediaWiki Phabricator:

https://phabricator.wikimedia.org/maniphest/task/create/?projects=MediaWiki-extensions-SocialProfile

It is recommended that you spend a while reading the documentation and
searching the archived discussions before posting a question - it is
possible that someone has experienced the same issue with this software
that you are experiencing currently.


==Customisation fields User Profile==

To change the number of custom fields, set variable wgSocialProfileNbCustomCustomFields to a value between 5 and 11 :
 $wgSocialProfileNbCustomCustomFields = 6;

The last field is using select box, and can be customized like this :
 $wgSocialProfileCustomFields = array (
 		"custom_12" => array (
 				'Jardinage',
 				'Sport',
 				'Cinema',
 				'Voiture',
 				'Moto',
 				'Voyage'
 		) 
 );
 
 You had to create several Mediawiki pages for each value you need in your 12 custom field. 
 For instance, with the above array you need : 
 MediaWiki:Custom_info_field12_Jardinage, which contains the value you need (jardinage)
 MediaWiki:Custom_info_field12_Sport (Sport) ...
 
 
 Moreover, you can use an another custom field with checkboxes and a system of parent/child but this time it's using a Property instead
 of Mediawiki pages. In your wiki you create a Property:Name_of_Property_Page and add your checkboxes' titles like this : 
 
* [[Allows value:: Name_level 1A / Name_level 2A / Name_level 3A ]]
* [[Allows value:: Name_level 1A / Name_level 2A / Name_level 3B]]
* [[Allows value:: Name_level 1A / Name_level 2B / Name_level 3A ]]
* [[Allows value:: Name_level 1A / Name_level 2B / Name_level 3B ]]
* [[Allows value:: Name_level 1B / Name_level 2A / Name_level 3A ]]
* [[Allows value:: Name_level 1B / Name_level 2A / Name_level 3B ]]
* [[Allows value:: Name_level 1B / Name_level 2B / Name_level 3A ]]
* [[Allows value:: Name_level 1B / Name_level 2B / Name_level 3B ]]

In your LocalSettings file add this line :
$wgSocialProfileCustomFieldsPropertyName='Name_of_Property_Page';

Also if you don't want to use custom 13 or cutom 12 , do not put anything in your LocalSettings file. And you won't have any error's 
 display. 


==To allow people sending messages==
 
 To allow connected users to send messages you had to add this line in your LocalSettings.php file :
 
 $wgGroupPermissions['user']['userboard-sendMessage']= true;
 
==To display little boxes==

When user is connected, if you want to diplay a little box with his own informations (name, avatar, about section) just add this line on your wikicode :
	{{#userInfo:}}

If you want to display a checkboxes to check if user says enough informations about him :
	{{#userInfoChecked:}}

Moreover, this extension checks also if user uploads an avatar. But the default image names : default_m.gif so if you want to check the avatar use this title to compare.

Note that the usage of userInfo or userInfoChecked force to disable cache on the page. So it is adviced to not use it on many pages.