====== ArchiveUpload Plugin ======

---- plugin ----
description: Allows to extract an archive (.zip/.tgz/.tar/.tar.gz/.gz) on upload
author     : Michael Klier
email      : chi@chimeric.de
type       : action
lastupdate : 2020-08-26
compatible : Ponder Stibbons
depends    : 
conflicts  : 
similar    : 
tags       : upload, archive, !discontinued

downloadurl: https://github.com/turnermm/dokuwiki-plugin-archiveupload/archive/master.zip
bugtracker : https://github.com/turnermm/dokuwiki-plugin-archiveupload/issues
sourcerepo : https://github.com/turnermm/dokuwiki-plugin-archiveupload
----
====  The current download has limitations ====

The original author's version does not work with the upgraded media manager. The ''Forked Update'' currently addresses this issue. If the new media manager is updated and then works with this plugin the fork will no longer be needed.

Additionally, there are issues with the TARLib module employed by this plugin. Consequently, in these cases it will unpack only zip files.
--- [[user>turnermm|Myron Turner]] //2013/06/03 17:25//

Not functional in current versions of media mananger. --- [[user>turnermm|Myron Turner]] //2016-08-26 11:26//

===== Description =====

This Plugin allows you to extract an archive directly on upload. It does all the mime-type and security checks DokuWiki normally does. Currently supported archive types are: ''.zip .tgz .tar .tar.gz .gz''. Once installed, it adds another checkbox to the upload form which, when ticked, will cause the plugin to try to extract the uploaded file as an archive.

{{https://trello.com/1/cards/5afe99cb256ee371033f4730/attachments/5afe9a41166f5c6239e5d70e/download/archiveupload.png?recache}}

===== Installation =====
Install using the Extension Manager.

 
===== Configuration =====

This plugin has no configuration options.

===== Changelog =====

A complete changelog can be found [[https://github.com/chimeric/dokuwiki-plugin-archiveupload/commits/|here]].

{{rss>https://github.com/chimeric/dokuwiki-plugin-archiveupload/commits/master.atom date}}

===== Bugs / Feature Requests =====

Please report bugs and feature requests at the [[https://github.com/chimeric/dokuwiki-plugin-archiveupload/issues|bug tracker]].

===== Discussion =====

==== Ignoring Directories ====

I've made a slight modification to my version: giving the option for directories to be ignored. Essentially, the user might have zipped the files in the current directory, might have zipped them from the directory above... there is no way of knowing until the files have been uploaded, and then it's a bit of a pain to move them.

So, a few minor tweaks:-

1. Add this into ''handle_form_output'' in ''action.php'' (also requires you to change the lang files):-

<code php>$event->data->addElement(form_makeCheckboxField('ignoredirs', 0, $this->getLang('ignoredirs')));</code>

2. Add the following to the ''lang/<your language>/lang.php'':-

<code php>
$lang['ignoredirs']         = 'Ignore archive directories';
</code>

3. Add the following into ''postProcessFiles'', after the line ''$fn_new = str_replace(':', '/', cleanID($fn_new));'':-

<code php>
if ( isset( $_REQUEST['ignoredirs'] ) )
{
    $lastslash = strrpos( $fn_new, '/' );
    $fn_new = ( $lastslash !== false ) ? substr( $lastslash, $lastslash+1 ) : $fn_new;

    if ( $fn_new == '' )
        continue;    // This is a directory, and these are being ignored
}
</code>

In my limited testing, this makes sure that all the files in the archive are put in the same directory.  -- [[public@ssbd.net|Andy Turner 2009-07-14 13:40]]

==== Firing MEDIA_UPLOAD_FINISH? ====

One thought that I've had - and I've not looked at whether this works or is feasible - I reckon that the ''MEDIA_UPLOAD_FINISH'' event should be fired for all of the uploaded files. For example, if I want to resize uploaded images to conform to a maximum size, I can't upload them by archive.

So, is it technically feasible to modify the action plugin to repeatedly fire MEDIA_UPLOAD_FINISH for each file uploaded? (Or am I talking nonsense and it does this already :-P)  -- [[public@ssbd.net|Andy Turner 2009-07-14 13:42]]