This is an old revision of the document!
Table of Contents
Socialite Plugin
Compatible with DokuWiki
Detritus,
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
Lightweight Social Buttons Plugin
This plugin allows you to add fully configurable lightweight and responsive social share buttons to your wiki.
Installation
Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.
Examples/Usage
See the plugin in action here. The sample page shows all the styles available with the plugin.
To add the lightweight social share buttons just at the tag ~~socialite~~
anywhere in you page. From the Dokuwiki configuration page, you can select three visualisation options (color
(default), name
, icon
) and the list of social buttons do display.
Option Display : color
. This option only uses css styles, so it is really lightweight:
Option Display : name
. Displays the social share icon and name:
Option Display : icon
. Displays a small button wit the social network icon:
Syntax
The following syntax is available:
~~socialite~~
uses the default display mode to print the default list of social buttons;~~socialite social1 social2 socialn~~
uses the default display mode to print the defined social buttons;~~socialite:icon~~
prints buttons with icons of the default list of social buttons;~~socialite:name social1 social2 socialn~~
prints buttons with names of the the defined social buttons;
Examples
To add the lightweight social share buttons just at the tag ~~socialite~~
anywhere in you page. This minimal configuration will use the default settings.
~~socialite~~
You can also select which buttons to display and in which order. This example displays Facebook and Twitter buttons:
~~socialite facebook twitter~~
Finally, you can define the display mode. This example displays buttons icons for Google+, Tumblr and Reddit:
~~socialite:icon googleplus tumblr reddit~~
Configuration and Settings
Default settings
You can define the socialite plugin default options in your Dokuwiki Configuration Page:
networks
This configuration setting allows you to select the default social network buttons to display and its sort order. Default networks are:twitter
facebook
googleplus
linkedin
pinterest
tumblr
reddit
taringa
andemail
.display
This configuration setting allows you to select the display mode:color
:<default> displays the name of the social network with its background color. This option only uses css so it is really lightweightname
: displays the icon and name of the social networkicon
: displays just the icon of the social network
twitter_user
Twitter username of content author (don't include “@”), to share via @twitter_user.
Local settings
Optionally, it is possible to define locally the display mode and network list. This will always override the default settings. Use the syntax ~~socialite[:display_mode] [network …]~~
to define local settings.
Development
Socialite plugin is hosted on GitHub.com.
Change Log
- update email address (2019-01-03 15:33)
- Correct plugin name in lang files (2019-01-03 15:33)
- Correct plugin name in lang files (2019-01-03 15:25)
- update release date (2019-01-02 17:21)
- Update button.php (2019-01-01 21:53)
- Merge pull request #16 from Klap-in/patch-1 (2019-01-01 21:44)
- let url point to the main page (2019-01-01 21:38)
- no string concatenation pt (2018-04-23 22:48)
Known Bugs and Issues
Check the Issue Tracker
ToDo/Wish List
FAQ
- This plugin counts the number of shares? No. To count and displays the number of shares lots of external scripts are injected on your site, the page will be much heavier and will take longer to download and display. This plugin only calls the external social site if and when you click on the button.
Discussion
Before reporting any issues (bugs or requests), please first take a look at the FAQ on plugin problems.
You can report any issues either on the Issue Tracker.
– Add your comments here —
Hi. I'm sorry but lsb
sounds like <CENSORED> Maybe to rename the plugin?— Aleksandr Selivanov 2015-08-27 11:07
Can you clarify what you mean? When I google “lsb”, nothing suspicious comes up. Is it language-specific and similar to the name for the UniversalEditButton? — Anika Henke 2015-09-05 14:37Hi, Aleksandr Selivanov, Anika Henke, I decided to rename the plugin, just in case. Also I was not happy with the previous name. Thanks both! — Fernando Ribeiro 2015-09-13 17:58Many thanks, Fernando! — Aleksandr Selivanov 2015-09-13 18:01
Hola! If you end up with this error: can't use method return value in write context
, an easy fix is to edit lib\plugins\socialite\syntax\button.php
file:
On line 132, edit
if ($this->getConf('twitter_user')) { $href .= "&via=" . rawurlencode($this->getConf('twitter_user')); }
And, on line 165, edit
if ($this->getConf('delicious_provider')) { $href .= "&provider=" . rawurlencode($this->getConf('delicious_provider')); }
Why? Because “empty() needs to access value by reference (in order to check whether that reference points to something that exists), and PHP before 5.5 didn't support references to temporary values returned from functions. (Please, see more on StackOverflow.)”
— moijafcor 2016-03-20 07:04