CINXE.COM

<!DOCTYPE html> <html lang="en" dir="ltr" class="no-js"> <head> <meta charset="utf-8" /> <title>plugin:extension [DokuWiki]</title> <meta name="generator" content="DokuWiki"/> <meta name="theme-color" content="#008800"/> <meta name="robots" content="index,follow"/> <meta name="keywords" content="plugin,extension"/> <link rel="search" type="application/opensearchdescription+xml" href="/lib/exe/opensearch.php" title="DokuWiki"/> <link rel="start" href="/"/> <link rel="contents" href="/plugin:extension?do=index" title="Sitemap"/> <link rel="manifest" href="/lib/exe/manifest.php"/> <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/feed.php"/> <link rel="alternate" type="application/rss+xml" title="Current namespace" href="/feed.php?mode=list&ns=plugin"/> <link rel="edit" title="Edit this page" href="/plugin:extension?do=edit"/> <link rel="alternate" type="text/html" title="Plain HTML" href="/_export/xhtml/plugin:extension"/> <link rel="alternate" type="text/plain" title="Wiki Markup" href="/_export/raw/plugin:extension"/> <link rel="canonical" href="https://www.dokuwiki.org/plugin:extension"/> <link rel="stylesheet" href="/lib/exe/css.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e"/> <script >var NS='plugin';var JSINFO = {"plugins":{"edittable":{"default columnwidth":""}},"id":"plugin:extension","namespace":"plugin","ACT":"show","useHeadingNavigation":0,"useHeadingContent":0};(function(H){H.className=H.className.replace(/\bno-js\b/,'js')})(document.documentElement);</script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.4/jquery.min.js" defer="defer"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.13.2/jquery-ui.min.js" defer="defer"></script> <script src="/lib/exe/js.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e&lang=en" defer="defer"></script> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="shortcut icon" href="/lib/tpl/dokuwiki/images/favicon.ico" /> <link rel="apple-touch-icon" href="/lib/tpl/dokuwiki/images/apple-touch-icon.png" /> <meta name="verify-v1" content="OVxl3gsCv2MhZqh1cBQyl0JytWXSwXMjyvwc+4w3WtA=" /> <meta name="google-site-verification" content="YhTVK69hW94ZXUtc2zSLPxTkZKbZIn0zK67mz5WQB-E" />  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-83791-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-83791-1', { 'anonymize_ip': true }); </script> </head> <body> <div id="dokuwiki__site"><div id="dokuwiki__top" class="site dokuwiki mode_show tpl_dokuwiki showSidebar hasSidebar">  <header id="dokuwiki__header"><div class="pad group"> <div class="headings group"> <ul class="a11y skip"> <li><a href="#dokuwiki__content">skip to content</a></li> </ul> <h1 class="logo"><a href="/start" accesskey="h" title="Home [h]"><img src="/lib/tpl/dokuwiki/images/logo.png" width="64" height="64" alt="" /><span>DokuWiki</span></a></h1> <p class="claim">It's better when it's simple</p> </div> <div class="tools group">  <div id="dokuwiki__usertools"> <h3 class="a11y">User Tools</h3> <ul> <li class="action login"><a href="/plugin:extension?do=login&sectok=" title="Log In" rel="nofollow"><span>Log In</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10 17.25V14H3v-4h7V6.75L15.25 12 10 17.25M8 2h9a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2v-4h2v4h9V4H8v4H6V4a2 2 0 0 1 2-2z"/></svg></a></li> </ul> </div>  <div id="dokuwiki__sitetools"> <h3 class="a11y">Site Tools</h3> <form action="/start" method="get" role="search" class="search doku_form" id="dw__search" accept-charset="utf-8"><input type="hidden" name="do" value="search" /><input type="hidden" name="id" value="plugin:extension" /><div class="no"><input name="q" type="text" class="edit" title="[F]" accesskey="f" placeholder="Search" autocomplete="on" id="qsearch__in" value="" /><button value="1" type="submit" title="Search">Search</button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form> <div class="mobileTools"> <form action="/doku.php" method="get" accept-charset="utf-8"><div class="no"><input type="hidden" name="id" value="plugin:extension" /><select name="do" class="edit quickselect" title="Tools"><option value="">Tools</option><optgroup label="Page Tools"><option value="edit">Edit this page</option><option value="revisions">Old revisions</option><option value="backlink">Backlinks</option></optgroup><optgroup label="Site Tools"><option value="recent">Recent Changes</option><option value="media">Media Manager</option><option value="index">Sitemap</option></optgroup><optgroup label="User Tools"><option value="login">Log In</option></optgroup></select><button type="submit">></button></div></form> </div> <ul> <li class="action recent"><a href="/plugin:extension?do=recent" title="Recent Changes [r]" rel="nofollow" accesskey="r">Recent Changes</a></li><li class="action media"><a href="/plugin:extension?do=media&ns=plugin" title="Media Manager" rel="nofollow">Media Manager</a></li><li class="action index"><a href="/plugin:extension?do=index" title="Sitemap [x]" rel="nofollow" accesskey="x">Sitemap</a></li> </ul> </div> </div>  <div class="breadcrumbs"> <div class="trace"><span class="bchead">Trace:</span> <span class="bcsep">•</span> <span class="curid"><bdi><a href="/plugin:extension" class="breadcrumbs" title="plugin:extension">extension</a></bdi></span></div> </div> <hr class="a11y" /> </div></header> <div class="wrapper group">  <nav id="dokuwiki__aside" aria-label="Sidebar"><div class="pad aside include group"> <h3 class="toggle">Sidebar</h3> <div class="content"><div class="group"> <p> <strong>Learn about DokuWiki</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/features" class="wikilink1" title="features" data-wiki-id="features">Features</a> & <a href="/blogroll" class="wikilink1" title="blogroll" data-wiki-id="blogroll">reviews</a> </div> </li> <li class="level1"><div class="li"> <a href="/install" class="wikilink1" title="install" data-wiki-id="install">Installation guide</a></div> </li> <li class="level1"><div class="li"> <a href="/manual" class="wikilink1" title="manual" data-wiki-id="manual">User manual</a> & <a href="/wiki:syntax" class="wikilink1" title="wiki:syntax" data-wiki-id="wiki:syntax">syntax</a></div> </li> <li class="level1"><div class="li"> <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">Release notes</a></div> </li> <li class="level1"><div class="li"> <a href="/faq" class="wikilink1" title="faq" data-wiki-id="faq">FAQ</a></div> </li> </ul> <p> <strong>Advanced Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/extensions" class="wikilink1" title="extensions" data-wiki-id="extensions">Extensions</a></div> </li> <li class="level1"><div class="li"> <a href="/development" class="wikilink1" title="development" data-wiki-id="development">Development manual</a></div> </li> </ul> <p> <strong>Corporate Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/faq:support" class="wikilink1" title="faq:support" data-wiki-id="faq:support">Get support</a></div> </li> <li class="level1"><div class="li"> <a href="/donate" class="wikilink1" title="donate" data-wiki-id="donate">Donations</a></div> </li> </ul> <p> <strong>Our Community</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/teams:getting_involved" class="wikilink1" title="teams:getting_involved" data-wiki-id="teams:getting_involved">Get involved</a></div> </li> <li class="level1"><div class="li"> <a href="/dokuinstall" class="wikilink1" title="dokuinstall" data-wiki-id="dokuinstall">Users</a></div> </li> <li class="level1"><div class="li"> <a href="http://forum.dokuwiki.org" class="urlextern" title="http://forum.dokuwiki.org">User forum</a></div> </li> <li class="level1"><div class="li"> <a href="/mailinglist" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">Development mailinglist</a></div> </li> </ul> <hr /> <p> Follow us on <a href="https://phpc.social/@dokuwiki" class="urlextern" title="https://phpc.social/@dokuwiki">Mastodon</a> and other <a href="/social" class="wikilink1" title="social" data-wiki-id="social">social networks</a>. </p> <p> <a href="/privacy" class="wikilink1" title="privacy" data-wiki-id="privacy">Our Privacy Policy</a> </p> </div></div> </div></nav>  <main id="dokuwiki__content"><div class="pad group"> <div class="pageId"><span>plugin:extension</span></div> <div class="page group">   <div id="dw__toc" class="dw__toc"> <h3 class="toggle">Table of Contents</h3> <div> <ul class="toc"> <li class="level1"><div class="li"><a href="#extension_manager_plugin">Extension Manager Plugin</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#description">Description</a></div></li> <li class="level2"><div class="li"><a href="#usage">Usage</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#listing_installed_plugins_and_templates">Listing Installed Plugins and Templates</a></div></li> <li class="level3"><div class="li"><a href="#enabling_disabling_plugins_and_templates">Enabling/Disabling Plugins and Templates</a></div></li> <li class="level3"><div class="li"><a href="#display_extension_details">Display Extension Details</a></div></li> <li class="level3"><div class="li"><a href="#installing_extensions">Installing Extensions</a></div></li> <li class="level3"><div class="li"><a href="#re-installing_and_updating">Re-Installing and Updating</a></div></li> <li class="level3"><div class="li"><a href="#uninstalling_extensions">Uninstalling Extensions</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#command_line_interface">Command Line Interface</a></div></li> <li class="level2"><div class="li"><a href="#file_permissions">File Permissions</a></div></li> <li class="level2"><div class="li"><a href="#possible_error_sources">Possible Error Sources</a></div></li> <li class="level2"><div class="li"><a href="#development">Development</a></div></li> <li class="level2"><div class="li"><a href="#bugs_feature_requests">Bugs/feature requests</a></div></li> </ul></li> </ul> </div> </div>  <h1 class="sectionedit1" id="extension_manager_plugin">Extension Manager Plugin</h1> <div class="level1"> <div class="pluginrepo_entry"><div class="usageInfo"><div class="compatibility"><p class="label">Compatible with DokuWiki</p><p>(bundled)</p></div></div><div class="mainInfo"><p class="description"><a class="media" href="/plugins"><img alt="plugin" class="medialeft" src="/lib/plugins/pluginrepo/images/dwplugin.png" width="60" height="60" /></a> Manage and install plugins and templates (bundled with DokuWiki)</p><a href="/_media/plugin:extensionmanager.png" class="media screenshot" title="Screenshot of extension" rel="lightbox" data-url="/_media/plugin:extensionmanager.png"><img src="/_media/plugin:extensionmanager.png?w=220&tok=90cdbd" alt="" width="220" /></a></div><div class="metaInfo"><dl><dt>Last updated on</dt><dd>2023-04-04</dd><dt>Provides</dt><dd><a href="/plugins?plugintype=2#extension__table" class="wikilink1" title="List all Admin plugins">Admin</a>, <a href="/plugins?plugintype=256#extension__table" class="wikilink1" title="List all CLI plugins">CLI</a></dd></dl></div><div class="moreInfo"><p class="tags">Tagged with <a href="/plugins?plugintag=%21bundled#extension__table" class="wikilink1" title="List all plugins with this tag">!bundled</a>, <a href="/plugins?plugintag=configuration#extension__table" class="wikilink1" title="List all plugins with this tag">configuration</a>, <a href="/plugins?plugintag=extension#extension__table" class="wikilink1" title="List all plugins with this tag">extension</a>, <a href="/plugins?plugintag=management#extension__table" class="wikilink1" title="List all plugins with this tag">management</a></p></div><div class="authorInfo"><strong>By <a href="mailto:michael%20%5Bat%5D%20content%20%5Bdash%5D%20space%20%5Bdot%5D%20de" class="mail" title="michael [at] content [dash] space [dot] de">Michael Hamann</a></strong><ul><li><a href="/plugin:text" class="wikilink1" title="plugin:text" data-wiki-id="plugin:text">text</a></li> <li><a href="/plugin:searchtext" class="wikilink1" title="plugin:searchtext" data-wiki-id="plugin:searchtext">searchtext</a></li> <li><a href="/plugin:mp3play" class="wikilink1" title="plugin:mp3play" data-wiki-id="plugin:mp3play">mp3play</a></li> <li><a href="/plugin:osm" class="wikilink1" title="plugin:osm" data-wiki-id="plugin:osm">osm</a></li> <li><a href="/plugin:saveandedit" class="wikilink1" title="plugin:saveandedit" data-wiki-id="plugin:saveandedit">saveandedit</a></li> <li><a href="/plugin:variants" class="wikilink1" title="plugin:variants" data-wiki-id="plugin:variants">variants</a></li> <li><a href="/plugin:indextitleonly" class="wikilink1" title="plugin:indextitleonly" data-wiki-id="plugin:indextitleonly">indextitleonly</a></li> <li><a href="/plugin:yql" class="wikilink1" title="plugin:yql" data-wiki-id="plugin:yql">yql</a></li> <li><a href="/plugin:move" class="wikilink1" title="plugin:move" data-wiki-id="plugin:move">move</a></li> <li><a href="/plugin:discussion" class="wikilink1" title="plugin:discussion" data-wiki-id="plugin:discussion">discussion</a></li> </ul></div></div> </div> <div class="secedit editbutton_section editbutton_1"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Extension Manager Plugin] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="extension_manager_plugin" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1-484" /><button type="submit" title="Extension Manager Plugin">Edit</button></div></form></div> <h2 class="sectionedit2" id="description">Description</h2> <div class="level2"> <p> The Extension Manager plugin allows <a href="/config:superuser" class="wikilink1" title="config:superuser" data-wiki-id="config:superuser">superusers</a> to administer installed plugins and templates and install new ones as listed in the <a href="/plugin:plugin" class="wikilink1" title="plugin:plugin" data-wiki-id="plugin:plugin">plugins</a> and <a href="/plugin:template" class="wikilink1" title="plugin:template" data-wiki-id="plugin:template">template</a> repositories. </p> </div> <div class="secedit editbutton_section editbutton_2"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Description] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="description" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="485-696" /><button type="submit" title="Description">Edit</button></div></form></div> <h2 class="sectionedit3" id="usage">Usage</h2> <div class="level2"> <p> The Extension Manager is accessible from the admin screen (Login as superuser, click “Admin” and choose “<a href="/lib/exe/fetch.php?cache=recache&tok=f015d7&media=https%3A%2F%2Fraw.githubusercontent.com%2Fdokuwiki%2Fdokuwiki%2Fmaster%2Flib%2Fplugins%2Fextension%2Fadmin.svg" class="media" title="https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/extension/admin.svg"><img src="/lib/exe/fetch.php?w=14&cache=recache&tok=f49e46&media=https%3A%2F%2Fraw.githubusercontent.com%2Fdokuwiki%2Fdokuwiki%2Fmaster%2Flib%2Fplugins%2Fextension%2Fadmin.svg" class="media" loading="lazy" alt="" width="14" /></a> Extension Manager”). </p> </div> <div class="secedit editbutton_section editbutton_3"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Usage] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="usage" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="697-948" /><button type="submit" title="Usage">Edit</button></div></form></div> <h3 class="sectionedit4" id="listing_installed_plugins_and_templates">Listing Installed Plugins and Templates</h3> <div class="level3"> <p> The Installed Plugins listing is the default action of the Extension Manager. The second tab lists the Installed templates. Each plugin or template is shown in its own row. The right hand side column contains action buttons like Disable/Enable, Install/Uninstall/Re-install and Update. Not all buttons are available in all circumstances. For example, there is no enable button for templates. </p> <p> Plugins and templates with gray font are currently disabled. </p> </div> <div class="secedit editbutton_section editbutton_4"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Listing Installed Plugins and Templates] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="listing_installed_plugins_and_templates" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="949-1454" /><button type="submit" title="Listing Installed Plugins and Templates">Edit</button></div></form></div> <h3 class="sectionedit5" id="enabling_disabling_plugins_and_templates">Enabling/Disabling Plugins and Templates</h3> <div class="level3"> <p> To disable or enable a plugin, you use the Disable and Enable buttons on the right hand side. </p> <p> Disabled plugins will no longer be loaded by DokuWiki, their <a href="/devel:css" class="wikilink1" title="devel:css" data-wiki-id="devel:css">stylesheets</a> and <a href="/devel:javascript" class="wikilink1" title="devel:javascript" data-wiki-id="devel:javascript">JavaScript</a> won't be loaded, and their syntax will no longer have any effect. </p> <p> Templates are activated and deactivated by selecting the <a href="/config:template" class="wikilink1" title="config:template" data-wiki-id="config:template">active template</a> in the <a href="/plugin:config" class="wikilink1" title="plugin:config" data-wiki-id="plugin:config">Configuration Manager</a>. </p> </div> <div class="secedit editbutton_section editbutton_5"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Enabling/Disabling Plugins and Templates] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="enabling_disabling_plugins_and_templates" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1455-1921" /><button type="submit" title="Enabling/Disabling Plugins and Templates">Edit</button></div></form></div> <h3 class="sectionedit6" id="display_extension_details">Display Extension Details</h3> <div class="level3"> <p> Pressing the arrow button in the rightbottom corner will display some basic information about the chosen plugin read from two sources, namely </p> <ol> <li class="level1 node"><div class="li"> DokuWiki's online repositories</div> <ul> <li class="level2"><div class="li"> for plugins: <a href="https://www.dokuwiki.org/plugin" class="urlextern" title="https://www.dokuwiki.org/plugin">https://www.dokuwiki.org/plugin</a></div> </li> <li class="level2"><div class="li"> for templates: <a href="https://www.dokuwiki.org/template" class="urlextern" title="https://www.dokuwiki.org/template">https://www.dokuwiki.org/template</a></div> </li> </ul> </li> <li class="level1 node"><div class="li"> the local info file that is installed with an extension</div> <ul> <li class="level2"><div class="li"> for plugins compare <a href="/devel:plugin_info" class="wikilink1" title="devel:plugin_info" data-wiki-id="devel:plugin_info">plugin info</a></div> </li> <li class="level2"><div class="li"> for templates compare <a href="/devel:template_info" class="wikilink1" title="devel:template_info" data-wiki-id="devel:template_info">template info</a></div> </li> </ul> </li> </ol> <p> The information of the repository is shown firstly, next it is completed with some info of the local info file. This local info can be outdated. </p> </div> <div class="secedit editbutton_section editbutton_6"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Display Extension Details] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="display_extension_details" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1922-2560" /><button type="submit" title="Display Extension Details">Edit</button></div></form></div> <h3 class="sectionedit7" id="installing_extensions">Installing Extensions</h3> <div class="level3"> <p> Extensions can add useful features, but please be aware that installing 3rd party code may pose a security risk. </p> </div> <h4 id="search_and_install_via_the_manager">Search and install via the manager</h4> <div class="level4"> <p> In the third tab “Search and Install” of the Extension manager you can search the extension repositories on dokuwiki.org for plugins and templates and install them using the “Install” button. </p> </div> <h4 id="manual_install">Manual Install</h4> <div class="level4"> <p> Plugins and templates not provided via the online repository or a version from a different download location can be installed via the fourth tab “Manual Install”. You can provide a url or choose an archive from your computer. </p> </div> <div class="secedit editbutton_section editbutton_7"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Installing Extensions] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="installing_extensions" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2561-3197" /><button type="submit" title="Installing Extensions">Edit</button></div></form></div> <h3 class="sectionedit8" id="re-installing_and_updating">Re-Installing and Updating</h3> <div class="level3"> <p> Depending on the <a href="#display_extension_details" title="plugin:extension ↵" class="wikilink1">automatically gathered information</a> about installed extensions you may see an additional button for “Re-Install” or “Update”. </p> <p> <img src="/lib/images/smileys/exclaim.svg" class="icon smiley" alt=":!:" /> If you have installed an extension that shares the same name as one in the online repository but is a different one, do <strong>not</strong> use this feature for it. </p> <p> You will see no such button for extensions that are not available in the online repository. This may be due to end of support, never having been added to the repository, or use of an alternative installation source. The latter especially for extensions that are installed using <a href="https://en.wikipedia.org/wiki/Git_(software)" class="interwiki iw_wp" title="https://en.wikipedia.org/wiki/Git_(software)">Git</a>. </p> </div> <h4 id="re-installing_an_extension">Re-Installing an Extension</h4> <div class="level4"> <p> Re-Installing may be useful if you are not sure if something may have spoiled your extension. </p> </div> <h4 id="updating_an_extension">Updating an Extension</h4> <div class="level4"> <p> When you press “Update” the Extension Manager will use the Download <abbr title="Uniform Resource Locator">URL</abbr> as provided via the online repository for retrieving updates. The extension manager will re-download the extension and install it again, overwriting the older version. </p> <p> For the update process to work properly it is necessary that the date “Last updated on” in the Dokuwiki Extension repository equals the date in the file <a href="/devel:plugin_info" class="wikilink1" title="devel:plugin_info" data-wiki-id="devel:plugin_info">plugin.info.txt</a> for plugins and <a href="/devel:template_info" class="wikilink1" title="devel:template_info" data-wiki-id="devel:template_info">template.info.txt</a> for templates in the source tarbal/zipfile. If this is not the case: the update will not take place or the “Update” signal persists. </p> <p> If an extension is updated, the Extension Manager will remove all the files listed in the <a href="/devel:deleted.files" class="wikilink1" title="devel:deleted.files" data-wiki-id="devel:deleted.files">deleted.files</a> file if such a file is added to the extension. </p> </div> <div class="secedit editbutton_section editbutton_8"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Re-Installing and Updating] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="re-installing_and_updating" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="3198-4824" /><button type="submit" title="Re-Installing and Updating">Edit</button></div></form></div> <h3 class="sectionedit9" id="uninstalling_extensions">Uninstalling Extensions</h3> <div class="level3"> <p> Every installed extension has an “Uninstall” button. </p> </div> <h4 id="manual_uninstall">Manual Uninstall</h4> <div class="level4"> <p> If the installation of a defective or conflicting extension broke the “Uninstall” button or made your whole wiki unavailable, you can delete it by removing the extension's directory (or ask your administrator to do so): </p> <ol> <li class="level1"><div class="li"> enter your wiki's filesystem</div> </li> <li class="level1"><div class="li"> go to the <code>/lib/tpl</code> (for a template) or <code>/lib/plugins</code> folder</div> </li> <li class="level1"><div class="li"> find the critical extension's folder and delete it</div> </li> </ol> <p> Alternatively, if the goal is to disable temporary the plugin due to issues, you can also first try to disable the plugin by adding the following line to the local config. </p> <dl class="code"> <dt><a href="/_export/code/plugin:extension?codeblock=0" title="Download Snippet" class="mediafile mf_php">/conf/plugins.local.php</a></dt> <dd><pre class="code php"><span class="re0">$plugins</span><span class="br0">[</span><span class="st_h">'pluginname'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="nu0">0</span><span class="sy0">;</span></pre> </dd></dl> </div> <div class="secedit editbutton_section editbutton_9"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Uninstalling Extensions] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="uninstalling_extensions" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="4825-5564" /><button type="submit" title="Uninstalling Extensions">Edit</button></div></form></div> <h2 class="sectionedit10" id="command_line_interface">Command Line Interface</h2> <div class="level2"> <p> The plugin also installs a <a href="/cli" class="wikilink1" title="cli" data-wiki-id="cli">command line plugin</a> which allows to do all the actions mentioned above from the command line. This is especially useful if you want to automate the setup of your DokuWiki. Eg. using salt or ansible. </p> <p> Run the following command in your DokuWiki directory for a list of commands and options: </p> <pre class="code">./bin/plugin.php extension --help</pre> </div> <div class="secedit editbutton_section editbutton_10"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Command Line Interface] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="command_line_interface" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="5565-5965" /><button type="submit" title="Command Line Interface">Edit</button></div></form></div> <h2 class="sectionedit11" id="file_permissions">File Permissions</h2> <div class="level2"> <p> To be able to install and modify your extensions, the webserver needs to be able to write to the <code>lib/plugins</code> or the <code>lib/tpl</code> directory and all files below. Refer to <a href="/install:permissions" class="wikilink1" title="install:permissions" data-wiki-id="install:permissions">permissions</a> for details on how set file permissions on various systems. </p> <p> The extension manager will detect missing file permissions and warn you when a plugin or a template could not be installed. You have to install extensions manually in this case, by downloading and unpacking them in <code>lib/plugins</code> or <code>lib/tpl</code> yourself. </p> </div> <div class="secedit editbutton_section editbutton_11"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[File Permissions] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="file_permissions" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="5966-6510" /><button type="submit" title="File Permissions">Edit</button></div></form></div> <h2 class="sectionedit12" id="possible_error_sources">Possible Error Sources</h2> <div class="level2"> <p> If you try to install extensions using the automatic download and install tool and get the error message “<em>No plugins found, or there has been an unknown problem during downloading and installing.</em>”, then you should check: </p> <ul> <li class="level1"><div class="li"> whether your server has activated the zlib (and/or bzip2) extension for php. To be sure, try the following: Download an extension, extract it, and rearchive it into a .tar file (without compression). Now try to use the download and install tool on that .tar file. If it works now, it is most likely that you just need to install the <code>php-zlib</code> package.</div> </li> <li class="level1"><div class="li"> whether your server is able to retrieve files over SSL (https://). Many extensions (correctly) use secure download links, including all those hosted on github. If your server is incorrectly setup to use SSL for file retrieval, try dropping SSL by deleting the 's' and changing the schema to 'http://'.</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_12"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Possible Error Sources] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="possible_error_sources" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="6511-7449" /><button type="submit" title="Possible Error Sources">Edit</button></div></form></div> <h2 class="sectionedit13" id="development">Development</h2> <div class="level2"> <p> The rewrite of DokuWiki's <a href="/plugin:plugin" class="wikilink1" title="plugin:plugin" data-wiki-id="plugin:plugin">Plugin Manager plugin</a> was part of <a href="/devel:gsoc" class="wikilink1" title="devel:gsoc" data-wiki-id="devel:gsoc">Google Summer of Code 2011</a> with <a href="https://forum.dokuwiki.org/u/piyushmishra" class="interwiki iw_user" title="https://forum.dokuwiki.org/u/piyushmishra">Piyush Mishra</a> as developer. Before inclusion it was rewritten by <a href="https://forum.dokuwiki.org/u/Michitux" class="interwiki iw_user" title="https://forum.dokuwiki.org/u/Michitux">Michitux</a> and <a href="https://forum.dokuwiki.org/u/Andi" class="interwiki iw_user" title="https://forum.dokuwiki.org/u/Andi">Andi</a>. </p> </div> <div class="secedit editbutton_section editbutton_13"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Development] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="development" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="7450-7723" /><button type="submit" title="Development">Edit</button></div></form></div> <h2 class="sectionedit14" id="bugs_feature_requests">Bugs/feature requests</h2> <div class="level2"> <p> Please refer to DokuWikis <a href="/bugs" class="wikilink1" title="bugs" data-wiki-id="bugs">bug tracker</a> for reporting bugs or feature requests. </p> </div> <div class="secedit editbutton_section editbutton_14"><form class="button btn_secedit" method="post" action="/plugin:extension"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1730610104" /><input type="hidden" name="summary" value="[Bugs/feature requests] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="bugs_feature_requests" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="7724-" /><button type="submit" title="Bugs/feature requests">Edit</button></div></form></div>  </div> <div class="docInfo"><bdi>plugin/extension.txt</bdi> · Last modified: <time datetime="2024-11-03T06:01:44+0100">2024-11-03 06:01</time> by <bdi>Aleksandr</bdi></div> <hr class="a11y" /> </div></main>  <nav id="dokuwiki__pagetools" aria-labelledby="dokuwiki__pagetools__heading"> <h3 class="a11y" id="dokuwiki__pagetools__heading">Page Tools</h3> <div class="tools"> <ul> <li class="edit"><a href="/plugin:extension?do=edit" title="Edit this page [e]" rel="nofollow" accesskey="e"><span>Edit this page</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg></a></li><li class="revs"><a href="/plugin:extension?do=revisions" title="Old revisions [o]" rel="nofollow" accesskey="o"><span>Old revisions</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M11 7v5.11l4.71 2.79.79-1.28-4-2.37V7m0-5C8.97 2 5.91 3.92 4.27 6.77L2 4.5V11h6.5L5.75 8.25C6.96 5.73 9.5 4 12.5 4a7.5 7.5 0 0 1 7.5 7.5 7.5 7.5 0 0 1-7.5 7.5c-3.27 0-6.03-2.09-7.06-5h-2.1c1.1 4.03 4.77 7 9.16 7 5.24 0 9.5-4.25 9.5-9.5A9.5 9.5 0 0 0 12.5 2z"/></svg></a></li><li class="backlink"><a href="/plugin:extension?do=backlink" title="Backlinks" rel="nofollow"><span>Backlinks</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10.59 13.41c.41.39.41 1.03 0 1.42-.39.39-1.03.39-1.42 0a5.003 5.003 0 0 1 0-7.07l3.54-3.54a5.003 5.003 0 0 1 7.07 0 5.003 5.003 0 0 1 0 7.07l-1.49 1.49c.01-.82-.12-1.64-.4-2.42l.47-.48a2.982 2.982 0 0 0 0-4.24 2.982 2.982 0 0 0-4.24 0l-3.53 3.53a2.982 2.982 0 0 0 0 4.24m2.82-4.24c.39-.39 1.03-.39 1.42 0a5.003 5.003 0 0 1 0 7.07l-3.54 3.54a5.003 5.003 0 0 1-7.07 0 5.003 5.003 0 0 1 0-7.07l1.49-1.49c-.01.82.12 1.64.4 2.43l-.47.47a2.982 2.982 0 0 0 0 4.24 2.982 2.982 0 0 0 4.24 0l3.53-3.53a2.982 2.982 0 0 0 0-4.24.973.973 0 0 1 0-1.42z"/></svg></a></li><li class="top"><a href="#dokuwiki__top" title="Back to top [t]" rel="nofollow" accesskey="t"><span>Back to top</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"/></svg></a></li> </ul> </div> </nav> </div>  <footer id="dokuwiki__footer"><div class="pad"> <div class="license">Except where otherwise noted, content on this wiki is licensed under the following license: <bdi><a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license" class="urlextern">CC Attribution-Share Alike 4.0 International</a></bdi></div> <div class="buttons"> <a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license"><img src="/lib/images/license/button/cc-by-sa.png" alt="CC Attribution-Share Alike 4.0 International" /></a> <a href="https://www.dokuwiki.org/donate" title="Donate" ><img src="/lib/tpl/dokuwiki/images/button-donate.gif" width="80" height="15" alt="Donate" /></a> <a href="https://php.net" title="Powered by PHP" ><img src="/lib/tpl/dokuwiki/images/button-php.gif" width="80" height="15" alt="Powered by PHP" /></a> <a href="//validator.w3.org/check/referer" title="Valid HTML5" ><img src="/lib/tpl/dokuwiki/images/button-html5.png" width="80" height="15" alt="Valid HTML5" /></a> <a href="//jigsaw.w3.org/css-validator/check/referer?profile=css3" title="Valid CSS" ><img src="/lib/tpl/dokuwiki/images/button-css.png" width="80" height="15" alt="Valid CSS" /></a> <a href="https://dokuwiki.org/" title="Driven by DokuWiki" ><img src="/lib/tpl/dokuwiki/images/button-dw.png" width="80" height="15" alt="Driven by DokuWiki" /></a> </div> <div style="margin-top: 2em; font-size:90%" class="dokuwiki"><div style="float:right"><a href="http://www.splitbrain.org/personal#imprint" style="float:right; text-decoration: none; color:#333">Imprint</a></div></div> <style type="text/css"> @media screen { body { padding-top: 30px; } #global__header { position: absolute; top: 0; left: 0; text-align: left; vertical-align: middle; line-height: 1.5; background-color: #333; box-shadow: 0 0 8px rgba(0,0,0,0.5); width: 100%; margin: 0; padding: 5px 20px; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; white-space: nowrap; overflow: hidden; } #global__header h2 { position: absolute; left: -99999em; top: 0; overflow: hidden; display: inline; } #global__header ul, #global__header li { margin: 0; padding: 0; list-style: none; display: inline; line-height: 1.5; } #global__header a { color: #bbb; text-decoration: none; margin-right: 20px; font-size: 14px; font-weight: normal; } #global__header a:hover, #global__header a:active, #global__header a:focus { color: #fff; text-decoration: underline; } #global__header form { float: right; margin: 0 0 0 20px; } #global__header input { background-color: #333; background-image: none; border: 1px solid #bbb; color: #fff; box-shadow: none; border-radius: 2px; margin: 0; line-height: normal; padding: 1px 0 1px 0; height: auto; } #global__header input.button { border: none; color: #bbb; } #global__header input.button:hover, #global__header input.button:active, #global__header input.button:focus { color: #fff; text-decoration: underline; } } /* /@media */ @media only screen and (min-width: 601px) { /* changes specific for www.dokuwiki.org */ #dokuwiki__header { padding-top: 3em; } #dokuwiki__usertools { top: 3em; } /* changes specific for bugs.dokuwiki.org */ div#container div#showtask { top: 40px; } } /* /@media */ @media only screen and (max-width: 600px) { body { padding-top: 0; } #global__header { position: static; white-space: normal; overflow: auto; } #global__header form { float: none; display: block; margin: 0 0 .4em; } } /* /@media */ @media print { #global__header { display: none; } } /* /@media */ </style> <div id="global__header"> <h2>Global DokuWiki Links</h2> <form method="get" action="https://search.dokuwiki.org/" target="_top"> <input type="text" name="q" title="Search all DokuWiki sites at once" class="input" /> <input type="submit" title="Search all DokuWiki sites at once" value="Search" class="button" /> </form> <ul> <li><a href="https://download.dokuwiki.org" title="Download the latest release" target="_top">Download</a></li> <li><a href="https://www.dokuwiki.org" title="Read the DokuWiki documentation" target="_top">Wiki</a></li> <li><a href="https://forum.dokuwiki.org" title="Ask questions in the DokuWiki forum" target="_top">Forum</a></li> <li><a href="https://irc.dokuwiki.org" title="Check IRC chat logs or join the chat" target="_top">IRC</a></li> <li><a href="https://github.com/splitbrain/dokuwiki/issues" title="Report and track bugs" target="_top">Bugs</a></li> <li><a href="https://translate.dokuwiki.org/" title="Help translating the DokuWiki interface" target="_top">Translate</a></li> <li><a href="https://github.com/splitbrain/dokuwiki" title="Access the most recent git commits" target="_top">Git</a></li> <li><a href="https://xref.dokuwiki.org/reference/dokuwiki/" title="Cross-Reference of the DokuWiki source code" target="_top">XRef</a></li> <li><a href="https://codesearch.dokuwiki.org/" title="Search through the sources of DokuWiki, plugins and templates" target="_top">Code Search</a></li> </ul> </div>  </div></footer> </div></div> <div class="no"><img src="/lib/exe/taskrunner.php?id=plugin%3Aextension&1733022841" width="2" height="1" alt="" /></div> <div id="screen__mode" class="no"></div></body> </html>