====== langdelete Plugin ======

---- plugin ----
description: Provides admin delete function for unnecessary language files and folders
author     : Taggic
email      : taggic@t-online.de
type       : admin-plugin
lastupdate : 2019-05-01
compatible : Ponder Stibbons, Binky, Weatherwax, Adora Belle, Elenor of Tsort
depends    : 
conflicts  : 
similar    : 
tags       : delete, language, maintenance

downloadurl: https://github.com/Taggic/langdelete/zipball/master
bugtracker : http://www.fristercons.de/fcon/doku.php?id=langdelete:issues
sourcerepo : https://github.com/Taggic/langdelete
donationurl: 
----

===== Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

This plugin provides an admin function to delete all language files and directories of your DW installation, which are unneccessarily there (so not used by you and your user).

Therfore open the Admin area and look to the section of further plugins. There you will find the "Delete languages" plugin.

With a click on that, a page will be opened where you can delete all language files and folders of your DokuWiki to reduce the space consumption on your web host. 

Simply define the language you want to keep. English as fundamental requirement will be kept also. All other language files and folders of inc and lib directory will be deleted. 

An input control provides you the possibility to specify the languages which should be kept on your system. Therefore you should insert the related ISO-Code like "en" for English and "de" for German. English will be kept in any case due to it is basic requirement and fall back if no language file for a specific language is available.

Please separate the ISO-codes by comma if you want to keep multiple languages. 

If you select the option "simulate only" nothing else than the language folders will be listed. This control is checked by default.

If you de-select it the files within these folders and the folders themselves will be deleted.

Please be aware that there is no undo feature and the languages, which you have deleted once, cannot be brought back by a single click (you have to reinstall the language packages for each plugin, template, etc.).

===== Configuration and Settings =====

A small css-file is provided to layout the input control div.

===== Development =====

=== Bugs ===

none

=== Change Log ===

Many thanks to Satoshi Sahara for the brush up Version.

{{rss>https://github.com/Taggic/langdelete/commits/master.atom date}}


===== FAQ =====

=== How to delete all languages except English ? ===

Insert en into the input box and press start.

=== Does it consider also folders outside of DokuWiki ? ===

No. The plugin is looping recursively “inc” and “lib” folder of DokuWiki. That considers plugins and templates, etc.

If you want to have a script for other folders then please visit following forum post, which was the initial trigger to develop this Plugin: \\ 
[[http://forum.dokuwiki.org/thread/7471|Alternative Sprachdateien löschen (German article)]]

===== Discussion =====

Please use only the [[http://forum.dokuwiki.org|DokuWiki Forum]] for discussion and [[http://www.fristercons.de/fcon/doku.php?id=langdelete:issues|Lang Delete issues]] to raise issues.

===== Forks =====

I forked this plugin and added a tree-view of what languages are available. You can install it using this URL: [[https://github.com/tqdv/langdelete/zipball/v1.1.0]]. Note that it replaces the original version. Here's [[https://i.imgur.com/MVjjcLq.png |a screenshot]] of it.  --- [[user>tilwa|tilwa]] //2019-05-01 13:53//