• View
• Edit
• History
• Attach
• Print
• Backlinks

Bookmarklet

Questions answered by this recipe

• How do I create bookmarklet links on a PMWiki page.
• I made my PMWiki site look like a web page without the "View Edit History Print" in the upper right. Is there an easier way to edit than typing "?action=edit" at the end of every URL?

Description

You can drag a bookmarklet link from your browser window to your bookmarks or to your bookmarks toolbar. I prefer the bookmarks toolbar because it makes it into a button for you.

This is useful if you have a wiki that you want to look like a web page without the "View Edit History Print" in the upper right. For instance, drag the bookmarklet link "edit" to the browser bookmark toolbar to create an Edit button. To edit a PMWiki page you can now just click the button. This will save you from having to click in the URL box and typing ?action=edit to the end of the url and then pressing enter. A big ergonomic improvement.

So whenever you are in a pmwiki that is more like a web page you are just 1 click away from actions.

• Do not confuse this recipe with the OtherBookmarklets or the AddLinkBookmarklet recipes. This recipe creates a bookmarklet link on a displayed PMWiki page. OtherBookmarklets only displays the code necessary to create a bookmarklet in your browser, but does not create a link on you PMWiki page. AddLinkBookmarklet uses a PMWiki page to keep links, I seen no relationship to this "Bookmarklet" recipe except for name.
• This recipe is secure because it only allows authors to reference bookmarklets which are predefined in your config.php or farmconfig.php file.

A working example of bookmarklets can be found at this link: Bookmarklet Example

New feature - Included are some new bookmarklet favicons for some PMWiki actions.

Bookmarklets in FireFox are not required to have name text if they have a icon (favicon). If you are happy with just an icon you can remove the name text. To do this first you must add an icon to your bookmarklet. You can install them easily using the freeware utility AM-DeadLink. Then right-click the bookmarklet and select properties from the popup context menu. Then clear the text in the "name" field and click the "OK" button.

Download them here: pm_bookmarklet_favicons.zipΔ

How To Use

There are 2 solutions here. The first one is for ALL PMWiki actions. The second one is for ONE individual bookmarklet. They both work with a wiki farm.

Installing for all actions

Copy Bookmarklet.phpΔ to your cookbook directory

In your config.php enter:

or in your farmconfig.php enter:

In you PMWiki page put code like this:

[[action:browse|View]]
[[action:edit|Edit]]
[[action:diff|History]]
[[action:upload|Upload]]
[[action:crypt|Crypt]]
[[action:print|Print]]
[[action:search|Search]]
[[action:source|Source]]
[[action:login|Login]]
[[action:logout|Logout]]
[[action:rss|RSS]]
[[action:atom|Atom]]
[[action:rdf|RDF]]
[[action:dc|DC]]
[[action:refcount|RefCount]]
[[action:ruleset|Ruleset]]
[[action:phpinfo|PHPInfo]]
[[action:diag|Diag]]
[[action:attr|Attributes]]

Installing for a single bookmarklet link.

# This is config.php code using Markup alone:

# create custom bookmarklet link
Markup('pmwikiedit', 'directives', '/\\(:pmwikiedit:\\)/',
     Keep("<a href='javascript:location.href+=\"?action=edit\"'>Edit</a>"));

Notes

You can create other kinds of bookmarklets by copying the code above and changing the word "action" to something else and by changing the javascript code.

Working example of bookmarklets can be found at this link:

Security

Currently when PMWiki sees "javascript:blahblahblah" in the page source code it just appends it to the end of the current page url. Patrick Michaud said it is not wise to allow wiki authors to use "javascript:blahblahblah" inside of a PMWiki page source because that would be a security risk. Specifically he said 'here's a page that demonstrates some XSS vulnerabilities using "javascript:" ... http://archives.neohapsis.com/archives/fulldisclosure/2005-10/0445.html '. This recipe is secure because it only allows authors to reference bookmarklets which are predefined in your config.php or farmconfig.php file.

Release Notes

This program is free software. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation http://www.fsf.org either version 2 of the License, or (at your option) any later version.

Copyright 2007 by GNUZoo (guru@gnuzoo.org)

Please donate to the author at url: http://gnuzoo.org/GNUZooPayPal

• 1.2 cleaner code, executes only for specific actions
• 1.1 Added RecipeInfo, made into an includeable script
• Initial Release

Comments

Great, thank you. Once you drag these link to your bookmark toolbar, you don't really need the recipe anymore. In fact, the easiest thing to do is to just visit a page on a site where this recipe is enabled, drag the links you want, and that's it. Until this recipe is enable on this page, you can visit the Bookmarklet page that Pm used to test this recipe. Pico August 16, 2006, at 11:42 PM:

This is great! How hard would it be to associate custom icons with the bookmarklet buttons? shi:

This is all very nifty, but you end up with pmwiki action buttons visible for all webpages. With Dynamic Page Actions you can display action links for logged in authorised editors, but hide them from site visitors who just browse. ~HansB

See Also

• OtherBookmarklets
• Dynamic Page Actions an alternative approach to provide "clean" pages for visitors, but action links for logged in editors.
• AddLinkBookmarklet uses a PMWiki page to keep links, I see no relationship to this "Bookmarklet" recipe except for name.

Contributors

• GNUZoo created this recipe and got Patrick Michaud to help
• Patrick Michaud primary code creator