######################################################## ## Mod Title: Gallery - phpBB2 Integration ## Mod Version: 1.4.3 ## ## $Date: 2003/08/10 18:23:24 $ ## $Revision: 1.1.2.1 $ ## ## Author: Martin (WebSnail) < www.snailsource.com > ## Description: This MOD integrates Gallery 1.3.4_pl1 ## with the phpBB2 users and usergroups (ver 2.0.6) ## ## Installation Level: Advanced ONLY! ## Installation Time: 10-15 Minutes ## Files To Edit: overall_header.tmpl ## page_header.php ######################################################## IMPORTANT: Please bookmark http://www.snailsource.com/ for future reference. All development, and future updates will be supported and made available from there. Version Information: ==================== Ver 1.4.3 - Martin < www.snailsource.com > 10-Aug-2003 ----------------------------- - Updated to provide compatability with Gallery 1.3.4_pl1 [NB: EDIT_PHPBB2.txt remains unchanged since 1.4.1] Requires: ========= - PhpBB2 2.0.6 - Gallery 1.3.4_pl1 ** THIS IS NOT A STANDALONE APPLICATION!! ** SQL Changes required: --------------------- (NB: These can be applied by running the sql_install.php file) ALTER TABLE phpbb_users ADD user_gallery_perm tinyint(1) unsigned NOT NULL default '0'; ALTER TABLE phpbb_groups ADD group_gallery_perm tinyint(1) unsigned NOT NULL default '0'; Included Files: =============== - modules.php (1.4.1) - sql_install.php (1.4.1) (delete after executing) - modules/gallery/albums.php (1.4.3) * - modules/gallery/captionator.php (1.4.3) * - modules/gallery/do_command.php (1.4.3) * - modules/gallery/init.php (1.4.3) * - modules/gallery/search.php (1.4.3) * - modules/gallery/slideshow.php (1.4.3) * - modules/gallery/slideshow_low.php (1.4.3) * - modules/gallery/utils.php (1.4.3) * - modules/gallery/view_album.php (1.4.3) * - modules/gallery/view_comments.php (1.4.3) * - modules/gallery/view_photo.php (1.4.3) * - modules/gallery/classes/Album.php (1.4.3) * - modules/gallery/classes/phpbb/User.php (1.4.1) - modules/gallery/classes/phpbb/UserDB.php (1.3.1) - modules/gallery/html_wrap/album.header (1.4.3) * - modules/gallery/html_wrap/gallery.header (1.4.3) * - modules/gallery/html_wrap/photo.header (1.4.3) * - modules/gallery/html_wrap/search.header (1.4.3) * - modules/gallery/html_wrap/wrapper.footer (1.4.3) * - modules/gallery/html_wrap/wrapper.header (1.4.3) * Files appended with a file version number eg: (1.4.x) have been updated in that version. Installation Instructions: ========================== 1. BACKUP ALL EXISTING FILES 2. Make the necessary mysql changes by running the file "sql_install.php" or make the changes manually as shown above. 3. *Move or install Gallery in .../phpBB2/modules/gallery/ (take into consideration the actual name for your phpBB2 directory) * You are advised to start with a fresh install !! (DO NOT jeopardise an existing gallery!) 4. Copy modified files over existing gallery files. 5. Edit files as shown in the "EDIT_PHPBB2" File (YOU DID BACK THEM UP FIRST DIDN'T YOU!) Upgrade Instructions: ===================== 1. Backup ALL EXISTING FILES 2. Upload the sql_install.php file then run by pointing your browser to it. 3. Overwrite existing Gallery files using those included in the MOD. 4. Edit the phpBB2 files as shown in the "EDIT_PHPBB2" file* [*There are a major number of changes since version 1.4.0] Usage Instructions: =================== First you need to be logged in to do more than just look at a Gallery Anyone who is an Administrator for the phpBB2 forum is automatically given Admin status on the Gallery. In addition you can provide individual users or usergroups with greater Gallery access throught he User or Usergroup Permissions Control Panel (in PhpBB2 Admin) - View - Normal access as per Gallerys own permissions - User - Ability to add new albums but still restricted as per Gallery permissions - Admin - Able to act a Gallery administrator. This functionality is not integrated beyond providing you with rough and ready global access to the gallery. You still need to use the Gallery native permissions system to make fine tuned adjustments. You will notice that the native Gallery system will show all users registered in your phpBB2 forum allowing you to provide permissions to them as per normal (for Gallery) :)... Please note running gallery outside of the modules.php system will work but won't allow you to use the permissions set for you as a phpBB2 user. Support: ======== This MOD is not supported by either the phpBB2 or Gallery developers. Any installation or use is taken ENTIRELY at your own risk and as such you accept FULL responsibility for any actions, problems or losses incurred as a result of its use. If you cannot accept responsibility for your own actions then do not use this MOD under any circumstances. In addition the MOD author can only support this MOD when there is sufficient spare time to do so. Polite enquiries without expectation tend to produce productive and useful results. Harrassment or abuse will result in nothing. Future Development: =================== Bug reports would be appreciated (www.snailsource.com/forum/). In addition various changes are likely to be made to further integrate the permissions system between the two projects. Contributions: ============== This MOD was created in response to requirements of the UKRag.net project which supports students in raising money for charities worldwide. Please support the authors efforts by supporting the project. If you can spare a small donation (can't be claimed as charitable funds sorry) towards its continued running they will not only ensure better support for UKRag but also this and other script MODs. Thanks. [ UKRag.net: http://www.ukrag.net/ ] CHANGLOG (PREV' VERSIONS) ========================= Ver 1.4.2 - Martin < www.snailsource.com > 07-Jan-2003 ----------------------------- - add_comments.php include > allows logged in username to be used with comments [name/email field hidden for all except admins] - save_photos.php now sets caption to include username uploading image nb: ONLY useful if captions cannot be edited by users after upload otherwise a simple edit will remove the username. - Updated to provide compatability with Gallery 1.3.3 Ver 1.4.1a - Martin < www.snailsource.com > 18-Dec-2002 ----------------------------- - Register Globals support was broken. Now fixed in following files - /modules.php - /modules/gallery/html_wrap/wrapper_header Ver 1.4.1 - Martin < www.snailsource.com > 29-Nov-2002 ----------------------------- - Improved administration integration. No longer need to create specific Gallery_admin or Gallery_user usergroups. - Register Globals is NO LONGER REQUIRED!!! (You have no idea how hard this was!!) - Small bugfix in captionator.php Ver 1.4.0 - Martin < www.snailsource.com > 27-Nov-2002 ----------------------------- - Compatability Update MOD Updated to work with Gallery ver. 1.3.2 Final - Updated the "EDIT_PHPBB2.txt" to include info on how to add a link to phpBB2 header - Included an example of overall_header.tpl to show where the code should go ;) Ver 1.3.4 - Martin 06-Aug-2002 ----------------------------- - BUG FIX: Modules.php has been updated to deal with an issue that seems to have been left over from phpBB2 changes when version 2.0.1 was released. Ver 1.3.3a (CVS sec' Update) - Martin 01-Aug-2002 ----------------------------- - SECURITY UPDATE: Updated again to deal with the late find re: captionator.php - Now works with Gallery CVS 1.3.1-b13. Ver 1.3.3 (CVS sec' Update) - Martin 01-Aug-2002 ----------------------------- - SECURITY UPDATE: Updated to protect from this security issue: http://gallery.menalto.com/modules.php?op=modload&name=News&file=article&sid=50&mode=thread&order=0&thold=0 - Now works with Gallery CVS 1.3.1-b12. Ver 1.3.1 (FINAL) - Martin 29-May-2002 ----------------------------- - Compatability Re-write MOD updated to provide compatability with Gallery 1.3.0 FINAL - BUGFIX: Fixed "LOGGEDIN" issues not working with "Anonymous" users - BUGFIX: ALL functionality (resize to window, etc.. should now work) Ver 1.3.0 - Martin Smallridge 12-May-2002 ----------------------------- - Compatability Re-write MOD updated to provide compatability with Gallery 1.3.0 RC4