pmfx / easy-2-gallery

A MODx Evolution 1.1+ image gallery

Easy 2 Gallery 1.5.3

A Multilanguage image gallery snippet and module (for MODx Evolution 1.1 and above) that offers features like image browsing, automatic thumbnail creation, size adjusting, watermarking, adding comments, etc..

Installation

1. Unpack archive in root folder of you modx installation

2. If this is your fresh installation: create a new folder 'gallery', the default path is assets/images/gallery. You can change this from the default.config.easy2gallery.php (fresh installation) from this value:

   'dir' => 'assets/images/gallery/',

   If this is an upgrade, this module will use the existing config.easy2gallery.php values.

3. Create new module, name it anything (Eg: Easy 2 Gallery), type:

###########
$o = include_once(MODX_BASE_PATH.'assets/modules/easy2/index.php');
return $o;
###########

And click save.

4. Refresh modx manager, then open the module tab.
5. Install following instructions.
6. If install is successful, remove install folder, manually or by clicking delete button. module won't work if this folder exists.

Upgrade

1. Unpack archive in root folder of you modx installation
2. If there is one (upgrade from below of E2G 1.4.0-rc4), COPY your existing config.easy2gallery.php file to assets/modules/easy2/includes/configs/ folder.
3. Open the module tab, upgrade following instructions
4. If upgrade is successful, remove install folder, manually or by clicking delete button. module won't work if this folder exists.
5. CLEAR MODX CACHE

NEW COMMENTS PROCESSING

Comments functionality has been removed from the class file and now has its own processor. A new view processor snippet shows the comments on the landing page, and in the popup window. See comments.readme.txt for full usage information.

Installation:

1. Create a new snippet, for this example named " easy2gallery_landingpage_comments " category: same as easy2gallery snippet code:

   define( 'E2G_MODE', 'true' );
   $e2g_path =MODX_BASE_PATH.'assets/modules/easy2/';
   include $e2g_path.'comments_processor.easy2gallery.php';
   

2. Create a new snippet, for this example named " easy2gallery_view_processor " Category: same as easy2gallery Snippet code:

   define( 'E2G_MODE', 'true' );
   $e2g_path =MODX_BASE_PATH.'assets/modules/easy2/';
   include $e2g_path.'view_processor.easy2gallery.php';
   
   return $output;
   

3. You need a landing page, if you don't have one set up yet see the help section in the module for that info.

   Content of the landing page:

   [!easy2? &landingpage=`47` &lp_img_src=`generated` &lp_w=`450` &lp_h=`450`!]
   

   [!easy2gallery_landingpage_comments?
   &ecl_page=`2`
   &captcha=`1`
   &comments_lang=``
   &approved=`1`
   &delay=`30`
   !]
   

4. Create a new document for the view processor. Doc settings:

   • blank template
   • all other settings off
   • published

   Doc content:

   [!easy2gallery_view_processor?
   &captcha=`1`
   &captcha_tpl=`captcha_tpl`
   &comments_lang=``
   &approved=`1`
   &delay=`90`
   !]
   

5. Open assets/modules/easy2/plugin.easy2gallery.php file in a text editor or File manager editor at the top find this line:

      $e2g_vpl_id = 48;
   

   Change the 48 to the id of your view processor document.

   Make sure to check the following events on the System Events tab: OnWebPageInit OnWebPageComplete

   See comments.readme.txt for full usage information.