This is a utility for DokuWiki plugin developers. End-Users should not bother with it.
This tool ensures that your plugins (and templates) have the proper version set in your github repository and on dokuwiki.org. This way end users should always see correct update information in the extension manager.
It will perform the following steps:
Yes, all of this is completely automatic. You could even set it up as a cronjob.
master
branch as the means of distributing the most current versioncomposer install
versionfix.php
- it will create an example ~/.dwversionfix.conf
file - edit it and add
public_repo
scope should be enough)You can let it update a single plugin:
versionfix.php myplugin
For updating a template, prefix the name with template:
versionfix.php template:mytemplate
Or you can let it run over all your plugins and templates registered at dokuwiki.org using the same email address as given on the plugin page:
versionfix.php [email protected]
Isn't this bad? Shouldn't versions be carefully selected and updated when needed?
Yes. In therory. But people (me) are bad at it. Since I point downloads to the master
branch anyway, people get my changes immeadiately anyway. This just ensures there are proper update messages in the extension manager.
Wouldn't it be better if dokuwiki.org would fetech uptodate info from github directly instead of relying on page updates?
Maybe. There is some redundancy between the plugin.info.txt
file and what is recorded at the dokuwiki.org plugin pages. Someone™ would need to extend our plugin repository to automatically get data from github, but nobody did, yet.
And we wouldn't want to force this development model (github, direct master downloads, etc.) on every plugin developer.
Vim or Emacs?
Vim! Though mostly IntelliJ Idea for PHP.