DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:socialite

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
plugin:socialite [2017-11-28 14:53]
93.108.234.215 [Default settings]
plugin:socialite [2019-04-15 22:10]
cpedraza [Discussion]
Line 4: Line 4:
 description:​ Adds responsive lightweight social share buttons anywhere on page description:​ Adds responsive lightweight social share buttons anywhere on page
 author ​    : Fernando Ribeiro ​ author ​    : Fernando Ribeiro ​
-email      : pinguim.ribeiro@gmail.com +email      : fribeiro@fribeiro.org 
 type       : syntax, type       : syntax,
-lastupdate : 2017-11-28 +lastupdate : 2019-01-01 
-compatible : "​Frusterick Manners",​ "​Elenor Of Tsort",​ Detritus,+compatible : "​Greebo", ​"​Frusterick Manners",​ "​Elenor Of Tsort",​ Detritus,
 depends ​   :  depends ​   : 
 conflicts ​ :  conflicts ​ : 
Line 27: Line 27:
 ===== Installation ===== ===== Installation =====
  
-Install ​the plugin using the [[plugin:plugin|Plugin ​Manager]] ​and the download URL above, which points to latest version of the plugin. Refer to [[:​Plugins]] on how to install plugins manually.+Search and install ​the plugin using the [[plugin:extension|Extension ​Manager]]. Refer to [[:​Plugins]] on how to install plugins manually.
  
 ===== Examples/​Usage ===== ===== Examples/​Usage =====
Line 33: Line 33:
 See the plugin in action [[https://​servidordebian.org/​en/​blog/​2015/​08_24_dokuwiki-plugin-socialite|here]]. The sample page shows all the styles available with the plugin. See the plugin in action [[https://​servidordebian.org/​en/​blog/​2015/​08_24_dokuwiki-plugin-socialite|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.+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 visualization ​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:​ color''​. This option only uses css styles, so it is really lightweight:​
  
 {{https://​servidordebian.org/​_media/​en/​blog/​2015/​dokuwiki-plugin-socialite-color.png?​}} {{https://​servidordebian.org/​_media/​en/​blog/​2015/​dokuwiki-plugin-socialite-color.png?​}}
  
-Option ''​Display : name''​. Displays the social share icon and name:+Option ''​Display:​ name''​. Displays the social share icon and name:
  
 {{https://​servidordebian.org/​_media/​en/​blog/​2015/​dokuwiki-plugin-socialite-name.png?​}} {{https://​servidordebian.org/​_media/​en/​blog/​2015/​dokuwiki-plugin-socialite-name.png?​}}
  
-Option ''​Display : icon''​. Displays a small button wit the social network icon:+Option ''​Display:​ icon''​. Displays a small button wit the social network icon:
  
 {{https://​servidordebian.org/​_media/​en/​blog/​2015/​dokuwiki-plugin-socialite-icon.png?​}} {{https://​servidordebian.org/​_media/​en/​blog/​2015/​dokuwiki-plugin-socialite-icon.png?​}}
- 
  
 ===== Syntax ===== ===== Syntax =====
Line 76: Line 75:
 ~~socialite:​icon googleplus tumblr reddit~~ ~~socialite:​icon googleplus tumblr reddit~~
 </​code>​ </​code>​
 +
 ===== Configuration and Settings ===== ===== Configuration and Settings =====
  
Line 82: Line 82:
 You can define the socialite plugin default options in your //Dokuwiki Configuration Page//: 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.\\ Available networks are: ''​twitter'',​ ''​facebook'',​ ''​googleplus'',​ ''​linkedin'',​ ''​pinterest'',​ ''​tumblr'',​ ''​reddit'',​ ''​taringa'',​ ''​stumbleupon'',​ ''​xing'',​ ''​vk''​ and ''​email''​. +  - ''​networks''​ This configuration setting allows you to select the default social network buttons to display and its sort order. Available networks are:\\ ''​twitter'',​ ''​facebook'',​ ''​googleplus'',​ ''​linkedin'',​ ''​pinterest'',​ ''​tumblr'',​ ''​reddit'',​ ''​taringa'',​ ''​stumbleupon'',​ ''​telegram'',​ ''​hackernews'',​ ''​xing'',​ ''​vk''​ and ''​email''​. 
-  - ''​display''​ This configuration setting allows you to select the display mode: +  - ''​display''​ This configuration setting allows you to select the display mode. Available options are
-    * ''​color''​:<default> displays ​the name of the social network with its background color. This option only uses css so it is really lightweight +    * ''​color'' ​(default) Displays ​the name of the social network with its background color. This option only uses css so it is really lightweight 
-    * ''​name'': ​displays ​the icon and name of the social network +    * ''​name'': ​Displays ​the icon and name of the social network 
-    * ''​icon'': ​displays ​just the icon of the social network +    * ''​icon'': ​Displays ​just the icon of the social network 
-  - ''​target'':​ Link target: specifies where to open the social network page.\\ Available options are: ''​_blank''​ (default)''​_self''​''​_parent'' ​and ''​_top''​.+  - ''​target'':​ Link target: specifies where to open the social network page.\\ Available options are: 
 +    * ''​_blank''​ (default): Opens the linked document in a new window or tab 
 +    * ''​_self''​: Opens the linked document in the same frame as it was clicked 
 +    * ''​_parent''​: Opens the linked document in the parent frame 
 +    * ''​_top''​: Opens the linked document in the full body of the window ​
   - ''​twitter_user''​ Twitter username of content author (don't include "​@"​),​ to share //via @twitter_user//​.   - ''​twitter_user''​ Twitter username of content author (don't include "​@"​),​ to share //via @twitter_user//​.
 +
 ==== Local settings ==== ==== 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. 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 ===== ===== Development =====
  
Line 108: Line 114:
 ===== FAQ ===== ===== 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.+  - **This plugin counts the number of shares?** No. To count and displays the number of shares lots of external scripts are injected ​in 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 ===== ===== Discussion =====
Line 115: Line 121:
  
 You can report any issues either on the [[https://​github.com/​fa-ribeiro/​dokuwiki-plugin-socialite/​issues|Issue Tracker]]. You can report any issues either on the [[https://​github.com/​fa-ribeiro/​dokuwiki-plugin-socialite/​issues|Issue Tracker]].
 + 
 // -- Add your comments here --- // // -- Add your comments here --- //
 +
 +Hi. When I use the ~~socialite:​icon~~ option it doesn'​t display just the icon. It displays the same as ~~socialite:​name~~ (i.e., **both** the name **and** the icon). If you check your own site, you'll see the problem there. --- [[user>​cpedraza|Carlos Pedraza]] //​2019-04-15 14:23//
 +
 +----
  
 Hi. I'm sorry but ''​lsb''​ sounds like <​CENSORED>​ :-( Maybe to rename the plugin?--- [[user>​Aleksandr|Aleksandr Selivanov]] //​2015-08-27 11:07// Hi. I'm sorry but ''​lsb''​ sounds like <​CENSORED>​ :-( Maybe to rename the plugin?--- [[user>​Aleksandr|Aleksandr Selivanov]] //​2015-08-27 11:07//
Line 123: Line 133:
 >> Hi, [[user>​Aleksandr|Aleksandr Selivanov]],​ [[user>​ach|Anika Henke]], I decided to rename the plugin, just in case. Also I was not happy with the previous name. Thanks both!  --- [[user>​Fernando Ribeiro|Fernando Ribeiro]] //​2015-09-13 17:58// >> Hi, [[user>​Aleksandr|Aleksandr Selivanov]],​ [[user>​ach|Anika Henke]], I decided to rename the plugin, just in case. Also I was not happy with the previous name. Thanks both!  --- [[user>​Fernando Ribeiro|Fernando Ribeiro]] //​2015-09-13 17:58//
 >>>​ Many thanks, Fernando! --- [[user>​Aleksandr|Aleksandr Selivanov]] //​2015-09-13 18:01// >>>​ Many thanks, Fernando! --- [[user>​Aleksandr|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: 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:
Line 151: Line 160:
  
 >> Thanks, Moises. --- [[user>​Aleksandr|Aleksandr Selivanov]] //​2016-03-20 20:23// >> Thanks, Moises. --- [[user>​Aleksandr|Aleksandr Selivanov]] //​2016-03-20 20:23//
- 
  
 Why does not the new window open? (target="​_blank"​ or popup window) //​2017-06-03//​ Why does not the new window open? (target="​_blank"​ or popup window) //​2017-06-03//​
 +
 +> Ok, you asked for it, you got it: Now you have an option to select link target :-)
 +> --- [[user>​Fernando Ribeiro|Fernando Ribeiro]] //​2017-11-28 14:42//
plugin/socialite.txt · Last modified: 2019-04-15 22:11 by cpedraza