summaryrefslogtreecommitdiffstats
path: root/user_guide
diff options
context:
space:
mode:
authorPhil Sturgeon <email@philsturgeon.co.uk>2010-05-11 12:41:59 +0200
committerPhil Sturgeon <email@philsturgeon.co.uk>2010-05-11 12:41:59 +0200
commit26872de184e4aa2ae92bae645782089e9656115d (patch)
treef00477488791602a0f582bb8c51434e9a933087e /user_guide
parente602683aa6362e2efeb03408cea749cfeaaeef4f (diff)
Added an option to remove the preceding trail of empty folders when creating a Zip archive.
Diffstat (limited to 'user_guide')
-rw-r--r--user_guide/changelog.html1
-rw-r--r--user_guide/libraries/zip.html12
2 files changed, 12 insertions, 1 deletions
diff --git a/user_guide/changelog.html b/user_guide/changelog.html
index ae63b1f5f..08c98157b 100644
--- a/user_guide/changelog.html
+++ b/user_guide/changelog.html
@@ -95,6 +95,7 @@ Hg Tag: </p>
<li>Added a <kbd>download()</kbd> method to the <a href="libraries/ftp.html">FTP library</a></li>
<li>Changed <kbd>do_xss_clean()</kbd> to return FALSE if the uploaded file fails XSS checks.</li>
<li>Added stripslashes() and trim()ing of double quotes from $_FILES type value to standardize input in Upload library.</li>
+ <li>Added a second parameter (boolean) to <kbd>$this->zip->read_dir('/path/to/directory', FALSE)</kbd> to remove the preceding trail of empty folders when creating a Zip archive. This example would contain a zip with "directory" and all of its contents.</li>
</ul>
</li>
<li>Database
diff --git a/user_guide/libraries/zip.html b/user_guide/libraries/zip.html
index 44603f2bc..844023b9e 100644
--- a/user_guide/libraries/zip.html
+++ b/user_guide/libraries/zip.html
@@ -177,7 +177,7 @@ $this->zip->download('my_backup.zip');
<h2>$this->zip->read_dir()</h2>
-<p>Permits you to compress a folder (and its contents) that already exists somewhere on your server. Supply a file path to the
+<p>Permits you to compress a folder (and its contents) that already exists somewhere on your server. Supply a file path to the
directory and the zip class will recursively read it and recreate it as a Zip archive. All files contained within the
supplied path will be encoded, as will any sub-folders contained within it. Example:</p>
@@ -189,6 +189,16 @@ $this->zip->read_dir($path);
$this->zip->download('my_backup.zip');
</code>
+<p>By default the Zip archive will place all directories listed in the first parameter inside the zip. If you only want the end folder to be in the zip
+you can pass <kbd>FALSE</kbd> (boolean) in the second parameter. Example:</p>
+
+<code>
+$path = '/path/to/your/directory/';<br /><br />
+$this->zip->read_dir($path, FALSE);
+</code>
+
+<p>This will create a ZIP with the folder "directory" inside, then all sub-folders stored correctly inside that.</p>
+