sfPhotoGalleryPlugin
Overview
sfIconPlugin is a Symfony plugin. You can use it to associate one or more photo (with thumbnail automatically created) to any persistent object present in your model.
Requirements
The following plugin is required:
The following plugins are optional:
The idea for future version is to remove these dependencies and build lighter versions
Installation
You can install sfPhotoGalleryPlugin via PEAR (recommended) package manager or manually.
PEAR installation
The easiest way to install sfPhotoGalleryPlugin is to use PEAR package manager.
$ symfony plugin-install http://plugins.symfony-project.com/sfPhotoGalleryPlugin
Alternatively, if you don't have PEAR installed, you can download the latest package attached to this plugin's wiki page and extract it under your project's plugins/ directory. You will also have to copy the contents of the myproject/plugins/sfIconPlugin/web/ directory into a myproject/web/sfIconPlugin/ directory.
Now clear the cache with symfony clear-cache command to enable the autoloading to find the new classes:
$ symfony cc
Rebuild the database and the model
$ symfony propel-build-all
Configuration
The following steps are needed. (To be improved and customizable)
Change the permission of the photo and thumbnails directories
$ chmod 777 plugins/sfPhotoGalleryPlugin/web
$ chmod 777 plugins/sfPhotoGalleryPlugin/web/thumbnails
Usage (Frontend)
Put the use_helper in your template
Use the sfPhotoGallery Helper
getId() ) {... ?>
getId(),$html_options=array()) ?>
getId(),$options=array()) ?>
Options for this helper:
* label=STRING (default is 'Add')
* icon=true (show image_multi icon needs sfIconPlugin
Usage (Backend)
Enable the module in your settings.yml
all:
.settings:
enabled_modules: sfPhotoGallery, ...
Clear the cache
$ symfony cc
Put the use_helper in your template
Use the sfPhotoGallery Helper
getId() ) {... ?>
getId(),$use_icon,$use_mbox) ?>
Options for this helper:
* label=STRING (default is 'Add Photo')
* icon=true (show image_multi icon, requires sfIconPlugin
* modalbox=true (open the image Borwser in a Modalox window, requires sfModalboxPlugin)
<?php echo photo_link_to_edit('entity',$entity->getId(),$options=array()) ?>
Options for this helper:
* modalbox => true
* label => 'Label link'
* icon => 'add' use sfIcon to show the link (sfIcon must bu installed)
* popup => array('Window title', 'width=310,height=400,left=320,top=0,toolbar=0,location=0,resizable=0'))
* page_title => Set the Gallery manager page_title
Changelog
2009-09-22: 0.1.5 beta
* more actions on manageGallery
* added popup option in photo_link_to_edit helper
* set new .css
2009-08-01: 0.1.4 beta
* more actions on manageGallery
2008-06-27: 0.1.3 beta
* Rank managing, added action manageGallery
2008-06-05: 0.1.2 beta
* Added html_options to photo_thumbnail_tag helper
2008-06-03: 0.1.1 beta
* Bug fix (thanks to Jonathan Bryan jonathan@ifranks.com, Karsten Redmer k.redmer@yahoo.de, Szentesi Zsolt szente@webkombinat.hu, pinedasoft@gmail.com)
2008-05-07: 0.1.0 beta
* Initial release
Todo
- CRUD for photoGallery and single Photo (EDIT AND DELETE)
- Rank management (inside a gallery)
- Set default values for constants and add the possibility to change them (app.yml)
- Improve options for helpers (modalbox and lightbox)
- Remove the thumbnails requirements
- Customize the image format allowed
Contacts
If you have any questions or feedback feel free to contact me at [mailto:piccioli@netseven.it].
Please include sfPhotoGalleryPlugin in the mail subject, this will help me tracking the conversation.
License
sfPhotoGalleryPlugin is a symfony plugin created by Alessio Piccioli.
For the full copyright and license information, please view the LICENSE file that was distributed with this source code.
