====== removeold Plugin ====== ---- plugin ---- description: To simply remove outdated DokuWiki system files author : Taggic email : Taggic@t-online.de type : admin lastupdate : 2016-07-07 compatible : 2013-12-08 Binky, 2014-09-29 Hrun depends : conflicts : similar : tags : remove, outdated, update downloadurl: https://github.com/Taggic/removeold/zipball/master bugtracker : #http://www.fristercons.de/fcon/doku.php?id=removeold:report #FIXME sourcerepo : https://github.com/Taggic/removeold donationurl: screenshot_img: https://trello.com/1/cards/64514afb11e8501671a00220/attachments/64514b3c99ba54f238979c5b/download/dokuwiki-plugin-removeold_summary.png ---- ===== Intro ===== {{ https://trello.com/1/cards/64514afb11e8501671a00220/attachments/64514b448fc0ffc66cb72904/download/dokuwiki-plugin-removeold_input.png?recache|removeold Plugin}} An up-to-date DokuWiki installation should not have any unused or outdated files from previous installations. This admin-plugin will delete these outdated files. ===== Usage ===== Login with your admin credentials and open the admin panel. There you will find within the section __**Additional Plugins**__ a link to open the UI of this plugin (__//Remove outdated files//__). Beside a small description a set of controls is provided. The textarea control is prefilled due to the valid file for your DokuWiki version is provided within the data folder (//deleted.files//). The same list for the latest DokuWiki release is provided by the core developers at [[:install:upgrade#files_to_remove|Upgrade - Files to remove]]. You may simply copy this list and paste it into the plugin textarea to overwrite the given values. __**Simulate only** (dry run)__ \\ This switch is turned on by default. It is to be used to check your system against the files provided within the textarea. The plugin does not take over any guarantee if the listed files are really obsolete. With option //dry run// it will check which of them are existent and accessible. The result will be displayed as a list of the files and a short text below the textarea input control (except the //Show summary only!// option is turned on). It is recommended to run a simulation first. __**Execution**__ \\ To really delete the files, switch off the simulation option and press Start. But first **Make a full backup** of your wiki (better safe than sorry). __**Summary only**__ \\ For quick checks especially on simulation it may be of interest to get just a brief overview about the result to be expected. To do so switch on the //Summary only!// option. This option can also be used on actual execution. It will suppress the detailed list of files and results. Instead, the output will be shrunk to something similar to: {{https://trello.com/1/cards/64514afb11e8501671a00220/attachments/64514b3c99ba54f238979c5b/download/dokuwiki-plugin-removeold_summary.png?recache}} \\ Following values may be given as result: ^ Text ^ Meaning ^ |File not found | The file does not exist on your system at the given path. | |Files deleted | **Simulation:** You have proper rights to delete this file\\ \\ **Execution:** You switched off the simulation option. That means your files are really deleted now. | |! ERROR ! | **Simulation:** You have no proper rights to delete this file or the file is inaccessible for another reason.\\ \\ **Execution:** A php-warning will be displayed and provides more information about the failure root cause (e.g. Permission denied). The files will still be existent. | \\ Example for a Warning on Simulation (Summary switched off!): {{https://trello.com/1/cards/64514afb11e8501671a00220/attachments/64514b4b28ea71a2f026bad7/download/dokuwiki-plugin-removeold_error.png?recache}} \\ Example for a Warning on Execution (Summary switched off!): {{https://trello.com/1/cards/64514afb11e8501671a00220/attachments/64514b34774ff1acbed43fc8/download/dokuwiki-plugin-removeold_warning-message.png?recache}} \\ __**Logging**__ \\ The plugin does provide also a logging of information about deleted files and files, which were not deleted due to an error (most probably due to file permission problem). The logfile is stored to //data/tmp/removeold.log//. Each execution will add the results to the file. Usually the feature is used once per DokuWiki release and will not lead into significant space consumption on your server. The following example illustrates the content. [25/Apr/2012 17:21:22] Files deleted lib/_fla/.htaccess [25/Apr/2012 17:21:23] Files deleted lib/_fla/MultipleUpload.as [25/Apr/2012 17:21:23] Files deleted lib/_fla/README [25/Apr/2012 17:21:23] Files deleted lib/_fla/index.html [25/Apr/2012 17:21:23] Files deleted lib/_fla/multipleUpload.fla [25/Apr/2012 17:21:23] Files deleted lib/exe/multipleUpload.swf ===== Installation ===== Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually. ===== Version / Requirements ===== There should be no dependencies to the DokuWiki release. ===== Development History ===== Please visit [[http://www.fristercons.de/fcon/doku.php?id=removeold::devel|→ Development History]] FIXME where you will find a chronological list of changes. ===== Recent Changes ===== {{rss>https://github.com/Taggic/removeold/commits/master.atom date}} ===== Discussion ===== Please use only the [[https://forum.dokuwiki.org/|DokuWiki Forum]] for discussion and the plugin related [[http://www.fristercons.de/fcon/doku.php?id=removeold:issuelist|Issue Tracker]] FIXME page (or even [[https://github.com/Taggic/removeold/issues|git]]) to raise issues. ===== FAQ ===== [[http://www.fristercons.de/fcon/doku.php?id=removeold:start#faq|fcon - removeold FAQ]] FIXME