Home / CMS/DMS : eZ publish / eZ DMS / Admin guide / Installation

Installation

eZ DMS is a 'meta extension' that bundle advanced workflows, notifications and permissions generation in one eZ Publish extension.

Requirements

eZ Publish 4.2 or above with the followings extensions;

  • regexpline
  • suggestkeyword
  • workflowboard
  • eztreeselection
  • ezapprove2 for eZ Publish 4.2

eZ DMS include a custom version of the ezmultiupload

We recommand also;

  • ezfind

Installation process

  1. Download the source code
  2. Deploy in the extension repository of your running eZ Publish
  3. Update your database schema according to the SQL code present in ezdms, ezapprove2 and ezfind extensions
  4. Use the 'package/list' interface of your eZ Publish administration interface to import the following classes;
    • ezdms_file
    • ezdms_folder
    • ezdms_staff
    • ezdms_customer
    • ezdms_cronjob
  5. Activate the extension for the ezdms siteaccess using settings/override/site.ini.append.php

    [ExtensionSetting]
    ActiveExtensions[]=ezdms
  6. Generate the autoloads

    run bin/php/ezpgenerateautoloads.php --extension
  7. Modify the settings in settings/override/site.ini.append.php

    [SiteSettings]
    SiteList[]=<your ezdms siteaccess>
    
    [SiteAccessSettings]
    AvailableSiteAccessList[]=<your ezdms siteaccess>
    RelatedSiteAccessList[]=<your ezdms siteaccess>
    
    MatchOrder=host
    HostMatchType=map
    HostMatchMapItems[]=<your ezdms subdomain>;<your ezdms siteaccess>
    
  8. Create a folder settings/siteaccess/<your ezdms siteaccess>
  9. Copy in this folder your default settings (taken for another siteaccess)
  10. The default design of eZ DMS is based on the 'Blue' design of ezwebin
  11. In settings/siteaccess/<your ezdms siteaccess>/design.ini.append.php check if you are using

    <?php /* #?ini charset="utf-8"?
    
    [StylesheetSettings]
    SiteCSS=var/storage/packages/eZ-systems/ezwebin_design_blue/files/default/file/site-colors.css
    ClassesCSS=var/storage/packages/eZ-systems/ezwebin_design_blue/files/default/file/classes-colors.css
    CSSFileList[]=yui/build/calendar/assets/calendar.css
    
    [JavaScriptSettings]
    JavaScriptList[]=insertmedia.js
    JavaScriptList[]=yui/build/yahoo-dom-event/yahoo-dom-event.js
    JavaScriptList[]=yui/build/calendar/calendar.js
    JavaScriptList[]=ezdatepicker.js
    */ ?>
  12. In settings/siteaccess/<your ezdms siteaccess>/site.ini.append.php check if you are using

    [SiteSettings]
    SiteName=eZ DMS - A Powerful DMS extension for eZ publish
    SiteURL=<your ezdms subdomain>
    IndexPage=/content/view/full/<your ezdms root node>/
    DefaultPage=/content/view/full/<your ezdms root node>/
    
    [DesignSettings]
    SiteDesign=ezdms
    AdditionalSiteDesignList[]=ezwebin
    AdditionalSiteDesignList[]=standard
    AdditionalSiteDesignList[]=base
  13. In your eZ DMS siteaccess add a 'contentstructuremenu.ini.append.php' file with the following to define the classes visible in the left menu

    <?php /* #?ini charset="utf-8"?
    
    [TreeMenu]
    # dynamic menu is: enabled/disabled
    Dynamic=enabled
    # enabled: automatically expand the options under the one clicked. May also be: disabled
    AutoopenCurrentNode=enabled
    
    # Just display the special eZ DMS Content Classes
    ShowClasses[]
    ShowClasses[]=ezdms_folder
    ShowClasses[]=ezdms_file
    ShowClasses[]=ezdms_staff
    ShowClasses[]=ezdms_customers
    ShowClasses[]=user_group
    */ ?>
  14. Using the administration interface of eZ publish, create a new folder and hide it. Copy it's node id in the ezmultiupload.ini.append.php file of the eZ DMS extension

    AvailableSubtreeNode[]
    AvailableSubtreeNode[]=<your hidden folder node ID>
    
    [FileTypeSettings_<your hidden folder node ID>]
    
    [ForceNode]
    NodeID=<your hidden folder node ID>
    
  15. Setup the cronjobs

    */1 * * * * cd /var/www/opennet; $PHP runcronjobs.php -s ezdms ezdmscronjobs
    */60 * * * * cd /var/www/opennet; $PHP runcronjobs.php -q -s ezdms ezdmsfilereminders
    01 0 * * * cd /var/www/move; $PHP runcronjobs.php -s ezdms purge_orphans

Workflow configuration

eZ DMS need several post publish workflows to manage files and reminders.

You should create one Multiplexer event, triggered a a post publish event to connect to the followings workflows

Workflow description Affected sections Classes to run Affected version
eZ DMS Customer placement Users eZ DMS Customers All versions
eZ DMS Customer placement Users eZ DMS Staff All versions
eZ DMS File create and update eZ DMS eZ DMS File All versions
eZ DMS File creation (Forced notifications) eZ DMS eZ DMS File Publishing new object
eZ DMS File multiple uploads eZ DMS eZ DMS File Updating existing object
eZ DMS File update (forced notifications) eZ DMS eZ DMS File Updating existing object
eZ DMS Folder creation (inherit permissions) eZ DMS eZ DMS Folder Publishing new object
eZ DMS Folder update (inherit permissions) eZ DMS eZ DMS Folder Updating existing object