Pub Link Fixup Plugin

For non-utf-8 sites, fix up Pub links to use correct encoding.

This plugin performs pub link fixup of the generated HTML page. If Foswiki is configured with a non-utf-8 {Store}{Encoding}, then links to /pub files will be generated with the incorrect encoding.

Even on non-utf-8 sites, Foswiki operates fully with UNICODE and utf-8 encoding in the core and on the web interface. /pub attachment links will be generated assuming the filesnames are utf-8 encoded. This plugin provides a completePageHandler that finds utf-8 encoded links to /pub attachments and re-encodes them to the {Store}{Encoding}.

Enable this plugin to perform the link fixup. It can be safely enabled regardless of the {Store}{Encoding}. If the Plugin detects that the {Store}{Encoding} is utf-8, it quietly disables its completePageHandler.

This is not a complete fix to the issue. It is still strongly recommended that sites convert their Store to utf-8 to avoid these types of encoding issues.


This plugin has one expert setting.
  • {Plugins}{PubLinkFixupPlugin}{Debug}. Enable to record before/after of each rewritten link to the Foswiki debug log.


You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See for more help.


Change History:  
1.00 (14 Sep 2015): Initial version

PackageForm edit

Author GeorgeClark
Version 1.00
Release 14 Sep 2015
Copyright © 2015, GeorgeClark, FoswikiContributors, All Rights Reserved
License GPL (GNU General Public License)
ExtensionClassification Data and Files
ExtensionType PluginPackage
Compatibility Foswiki 2.0
IncompatibleWith 1.1.9, 1.1.8, 1.1.7, 1.1.6, 1.1.5, 1.1.4, 1.1.3, 1.1.2, 1.1.1, 1.1.0, 1.0.10, 1.0.9, 1.0.8, 1.0.7, 1.0.6, 1.0.5, 1.0.4, 1.0.3, 1.0.2, 1.0.1, 1.0.0
DemoUrl http://
SupportUrl PubLinkFixupPlugin
ModificationPolicy FollowsReleaseProcess
Topic attachments
I Attachment Action Size Date Who Comment
PubLinkFixupPlugin.md5md5 PubLinkFixupPlugin.md5 manage 177 bytes 01 Oct 2015 - 16:30 GeorgeClark  
PubLinkFixupPlugin.sha1sha1 PubLinkFixupPlugin.sha1 manage 201 bytes 01 Oct 2015 - 16:30 GeorgeClark  
PubLinkFixupPlugin.tgztgz PubLinkFixupPlugin.tgz manage 5 K 01 Oct 2015 - 16:29 GeorgeClark  
PubLinkFixupPlugin.zipzip manage 9 K 01 Oct 2015 - 16:29 GeorgeClark  
PubLinkFixupPlugin_installerEXT PubLinkFixupPlugin_installer manage 4 K 01 Oct 2015 - 16:30 GeorgeClark  
Topic revision: r4 - 01 Oct 2015, GeorgeClark - This page was cached on 15 Feb 2018 - 18:24.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License