Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
History plugin enables file versioning.
When user uploads or copies file that already exists, the older file is versioned.
Versioned files are shown in the file listing, where they can be viewed, removed or restored.
Installation & Configuration
History plugin requires Kloudspeaker version 2.6 or later.
History plugin is installed with following steps:
- Extract plugin zip package into "backend/plugin" folder (for installing plugin outside installation folder, see customization instructions)
- Add plugin configuration into "configuration.php" (see configuration options below)
- Run Kloudspeaker updater
Example minimum configuration:
$CONFIGURATION = array( ... "plugins" => array( "History" => array( "folder" => "/data/kloudspeaker/history" ), ... ) );
History plugin has following options:
folder: Server filesystem path to the folder where versions are managed (use absolute path). Required
max_versions: The maximum number of versions stored for each file. When number is exceeded, older versions are removed. By default, there is no restriction on number of versions.
exclude_folders: List of root folder IDs that are excluded from version handling, by default all folders are included
store_current_on_restore: Whether current file is versioned when older version is restored, by default TRUE
version_on_copy: Whether copy action over existing file will version the current file, by default TRUE
version_on_move: Whether move action over existing file will version the current file, by default FALSE. Note that enabling this feature will delete the source file, as it will become a version on the target file.
NOTE! Folder used for version storage should not be
- exposed via web server (ie. use location outside web root), only PHP needs read/write access to it
- accessed/modified by other than plugin itself, as any modifications to the internal version data files may corrupt versioning. This includes a) publishing the folder in Kloudspeaker itself and b) modifying the files directly with FTP or server filesystem etc.
Example full configuration:
$CONFIGURATION = array( ... "plugins" => array( "History" => array( "folder" => "/data/kloudspeaker/history", "max_versions" => 3, "exclude_folders" => array("2") ), ... ) );
Plugin is released with Commercial Plugin license.
License costs 150 EUR, and can be downloaded from Download page.