DokuWiki

It's better when it's simple

User Tools

Site Tools

Trace:
plugin:socialite

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
plugin:socialite [2016-10-16 17:21] – [Discussion] Fernando Ribeiroplugin:socialite [2023-10-30 22:32] (current) – Klap-in
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 : 2015-09-13 +lastupdate : 2019-01-01 
-compatible : "Elenor Of Tsort", Detritus,+compatible : Detritus, Elenor of Tsort, Frusterick Manners, Greebo, Hogfather
 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 53: Line 52:
  
   * ''~~socialite~~'' uses the default display mode to print the default list of social buttons;   * ''~~socialite~~'' uses the default display mode to print the default list of social buttons;
-  * ''~~socialite social1 social2 social//n//~~'' uses the default display mode to print the defined social buttons;+  * ''~~socialite: social1 social2 social//n//~~'' 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:icon~~'' prints buttons with icons of the default list of social buttons;
   * ''~~socialite:name social1 social2 social//n//~~'' prints buttons with names of the the defined social buttons;   * ''~~socialite:name social1 social2 social//n//~~'' prints buttons with names of the the defined social buttons;
Line 68: Line 67:
  
 <code> <code>
-~~socialite facebook twitter~~+~~socialite: facebook twitter~~
 </code> </code>
  
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. Default networks are: ''twitter'' ''facebook'' ''googleplus'' ''linkedin'' ''pinterest'' ''tumblr'' ''reddit'' ''taringa'' 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): 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 107: 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 114: 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 is replicated 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 122: 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 142: Line 152:
  --- [[user>moijafcor|Moises Jafet]] //2016-03-20 07:04//  --- [[user>moijafcor|Moises Jafet]] //2016-03-20 07:04//
  
-Thanks [[user>moijafcor|Moises Jafet]], this is now fixed! +> Thanks [[user>moijafcor|Moises Jafet]], The ''error: can't use method return value in write context'' is now fixed! 
- +> --- [[user>Fernando Ribeiro|Fernando Ribeiro]] //2016-10-16 17:19//
- --- [[user>Fernando Ribeiro|Fernando Ribeiro]] //2016-10-16 17:19//+
  
 Dear [[user>Aleksandr|Aleksandr Selivanov]], as some mobile browsers can have issues displaying *.ico files, please explore the possibility of using *.png files instead. Just my two cents ;-). Dear [[user>Aleksandr|Aleksandr Selivanov]], as some mobile browsers can have issues displaying *.ico files, please explore the possibility of using *.png files instead. Just my two cents ;-).
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//
 +
 +> 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.1476631282.txt.gz · Last modified: 2016-10-16 17:21 by Fernando Ribeiro
Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki

Global DokuWiki Links