====== BookmarkMe plugin ======

---- plugin ----
description: Creates links to various social bookmark services
author     : Ilya Lebedev 
email      : ilya@lebedev.net
type       : syntax, action
lastupdate : 2008-02-02
compatible : 2007-06-26b
depends    : 
conflicts  : 
similar    : 
tags       : bookmarks, delicious, digg, StumbleUpon
----

[[http://debugger.ru/dl/bookmarkme.zip|BookmarkMe v0.7 (31Kb, zip)]]\\ [[http://debugger.ru/dl/bookmarkme.7z|BookmarkMe v0.7 (22Kb, 7z)]]\\ [[https://svn.debugger.ru/repos/common/DokuWiki/BookmarkMe/tags/BookmarkMe.v0.7| SVN repository, v0.7]]


This [[plugin]] shows the toolbar with links to the bookmarking services:
  * del.icio.us
  * Digg
  * Furl
  * Reddit
  * Ask
  * BlinkList
  * blogmarks
  * Blogg-Buzz
  * Google
  * Ma.gnolia
  * Netscape
  * ppnow
  * Rojo
  * Shadows
  * Simpy
  * Socializer
  * Spurl
  * StumbleUpon
  * Tailrank
  * Technorati
  * Windows Live
  * Wists
  * Yahoo!
  * BobrDobr
  * Memori
  * Faves (BlueDot)
  * Add to Favorites (IE, FireFox, Opera compatible)
  * Facebook
  * Newsvine
  * Yahoo! Bookmar
  * Twitter
  * myAOL
  * Slashdot
  * Fark
  * RawSugar
  * LinkaGoGo
  * Mister Wong
  * Wink
  * BackFlip
  * Diigo
  * Segnalo
  * Netvouz
  * DropJack
  * Feed Me Links
  * funP
  * HEMiDEMi

{{http://debugger.ru/dl/bookmarkme.gif?586x81}}

====== Syntax ======
BookmarkMe support simple syntax to force enable or disable the toolbar on the page.

<code>
~~BOOKMARKME:on|off~~
</code>

====== Configuration ======
Plugin allows to configure the following:
  - list of available services
  - list of pages/namespaces, where plugin should be disabled
  - turn plugin on/off

All these options are available at the Configuration Manager.
===== Bookmark.ini ==
Bookmark.ini is a place, where you can add more bookmarking services to show on the toolbar.
File format
<code>
Service_name <space(s)> service_url <CR>
</code>

Service icon should be placed in the **/img** folder and meet the following rules:
  - has the same name, as service
  - has no dots in the name
  - has spaces replaced with underscores
  - to be lowercase
  - has the '.gif' extension

====== How to install ======
Download the [[http://debugger.ru/dl/bookmarkme.zip|bookmarkme.zip]] and unpack it into ''lib/plugins'' folder or use the [[plugin:plugin]] manager.

Note, you may need to reset DW's cache to see the toolbar.


====== Changelog ======
  * **2008-02-02 Version 0.7**:
    * fixed configuration metadata (thanks to Luca Corbo)
    * fixed some urls
  * **2007-12-11 Version 0.6**:
    * added 18 more services + "Add to favorites" button for Opera, Mozilla, IE
    * updated icons for better-looking
    * updated CSS
  * **2007-12-11 Version 0.5**:
    * added russian translation
    * added support for BobrDobr, Memori, Faves (BlueDot) services
    * updated styles
    * added option to hide plugin header (leaves icons only)
    * icon title now is language-dependent and support %what% and %where% placeholders, replaced with page title and service name respectively.
  * **2007-09-04 Version 0.4**:
    * added array_combine emulation, to make plugin compatible with PHP4
    * fixed check for icons presence
  * **2007-05-04 Version 0.3**:
    * added German language
    * added support for bookmark.ini file, to place additional serivces.
  * **2007-23-03 Version 0.2**:
    * added ~~BOOKMARKME:on~~ tag
    * fixed bug with relative URL in queries
    * added 'wiki:syntax' to the list of skipped pages
  * **2007-22-03 Version 0.1**:
    * First public release.









====== Bugs ======
> Download link is unavailable.
Fixed. --- //[[ilya@lebedev.net|Ilya Lebedev]] 2008-02-04 11:21//

====== Discussion ======

====== Feature request =====

> Neat plugin, but would it be possible to add a couple of configuration items?
>  * location:  The bookmark bar hangs on the bottom of the page content.  I'd like to put it in the bottom bar or in a special bar just above it, but I cannot understand the code well enough to see how it gets where it is.  Another optional location would be in leftbar/rightbar for those who have them.
Please describe these features, as you see them. I don't understand why do you want to show bookmarking bar above the text.... And i don't see a chance to place icons in the sidebar, other than patching a template.

>  * the css allows control of borders and right or left alignment, but an option to omit the header line (or put it inline on the left of the icons?) and to alter the text in it without having to hack the code would IMO be cool.
>--- //[[richard@the-place.net|richard]] 2007-10-16//

DokuWiki does not allow to alter translations, thus i don't see a chance to change strings, without changing the code.

Option to hide the header has been added in 0.5 release.
 --- //[[ilya@lebedev.net|Ilya Lebedev]] 2007-11-12 01:10//

I second the location stuff above, i would like to be able to define easily in the plugin where it should display the icons - not just before or after page text - ie. in the bottom toolbar, in the top toolbar etc..
- I have installed this plugin on my site: http://www.simpleinvoices.org/start and works well - just want to move the icons around
//[[http://www.simpleinvoices.org|justin]] 2008-06-02//