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 revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
plugin:socialite [2017-11-28 15:01] – [Discussion] 93.108.234.215plugin:socialite [2019-04-15 22:10] – [Discussion] cpedraza
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. Available options are:   - ''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
Line 89: Line 89:
   - ''target'': Link target: specifies where to open the social network page.\\ Available options are:   - ''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     * ''_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 (this is default)+    * ''_self'': Opens the linked document in the same frame as it was clicked
     * ''_parent'': Opens the linked document in the parent frame     * ''_parent'': Opens the linked document in the parent frame
     * ''_top'': Opens the linked document in the full body of the window      * ''_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 112: 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 119: 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 127: 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 159: Line 164:
  
 > Ok, you asked for it, you got it: Now you have an option to select link target :-) > Ok, you asked for it, you got it: Now you have an option to select link target :-)
-> --- [[user>Fernando Ribeiro|Fernando Ribeiro]] //2016-10-16 17:19//+> --- [[user>Fernando Ribeiro|Fernando Ribeiro]] //2017-11-28 14:42//
plugin/socialite.txt · Last modified: 2023-10-30 22:32 by Klap-in

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