*********************************
* *
* ReadMe - freePHPgallery 2.0 *
* *
*********************************
======================
===== How to use =====
======================
freePHPgallery 2.0 requires PHP 5 >= 5.5.0 or above
Unzip the downloaded zip-file into an folder on your server. This folder must be reachable by your web-server.
Adjust the .user.ini file and .htaccess files according to your needs (the .htaccess files were made to work with the apache-server).
Depending on your web-server configuration it might be necessary to adjust the rights (read/write/execute) of some files and folders. The files ./index.php and ./fileserver.php must be executable, the folders ./stack, ./users and ./work including their sub-folders must be writable, as well as the .php-files in ./stack and ./users. Everything else must be readable by the web-server.
Customize the "Contact and Legal Notices" files at ./config/lang/legal_notice.
Address the freePHPgallery folder (.) or the ./index.php file with your browser (depending on your server configuration).
Go to 'User login', enter the username 'root'. The password you type in for the first time will be your password.
Go to 'Upload files' and start your freePHPgallery experience ;-)
=> If you are upgrading:
Go to your profile as administrator ('root' is admin by default).
At the bottom of the page you will find an link to import files from another freePHPgallery-installation.
Follow the instructions on that page.
If you did any changes to ./config/config.php in the other installation, you will have to redo them in this manually.
=> If you want to transfer files directly into the gallery you should:
- log out
- add your preferred folders inside the ./stack folder
- log in as administrator
The added folders will be your gallery albums.
Note that you should not add files into the ./stack folder. Only add folders. Files in the ./stack folder will not appear in the gallery.
Subfolders in ./stack are not taken into account and are not displayed in the gallery either.
All administrative options are displayed in the album-, item- or profile-pages when logged in and should be self-explanatory.
If you want that the server does the delivery of the obfuscated files directly, instead over the fileserver.php-file,
then give a look into the ./modules/rewrite_map.php. It might be faster if the server does the job.
===== Configuration =====
You can make several changes to the configuration of the gallery in the ./config/config.php file.
All possible changes are explained in that file.
===== Design =====
In the ./public/ folder you will find the used icons (./img) and the css-file.
You can modify/adjust both according to your wishes.
===== Multiple languages =====
freePHPgallery supports the use of multiple languages.
You can translate one of the already existing language files in ./config/lang to the language of your choice and rename it to something like 'Spanish.php'.
Copy it into the ./config/lang directory and make it readable.
The same applies to the files in ./config/lang/legal_notice.
It would be nice, if you provide your translated files to other users by sending them to
https://sourceforge.net/projects/freephpgallery/support
=====================
===== Changelog =====
=====================
Changes in version 2.0 (December 2018)
-> Designed for mobiles, tablets and desktop computers
-> Added ability
* for admins to add/remove users and set/change their password
* for all users to change their password, set their preferred language and choose if all albums should be shown to them or only their own albums
* to add all kind of files
* to convert video files if ffmpeg is installed on the server
* to import files from another freePHPgallery-installation
-> If ffmpeg is installed on the server videos can get an pre-image taken from the middle of the video
-> Albums can be set to private. This albums are not shown to guests and other users (admins can see all)
-> Links to private albums can be shared. Anyone who has this link can see this private album until the browser is closed
-> The user profile settings and the private files and folders can be addressed by https (SSL/TLS), if your server supports it
-> Albums can be displayed as gallery (= as before) or as an explorer-list, with a click on the name of the album
-> All gallery-files are obfuscated and protected against unauthorized access. The delivery of the files can be managed by PHP (./fileserver.php) or over the server (see comment/instruction in ./modules/rewrite_map.php)
-> Clicking on the left or right side of the shown single item will lead you forward or backward in the gallery, clicking twice at the center will show the file in a new browser window at full size - finger gestures are supported
-> Small basic design changes
-> Left sidebar can be hidden and shown again
-> The code was made more modular. Now there is only one file (index.php) that manages everything. The different tasks are done by modules
-> Access and Cache-Control are set by .htaccess-files
-> The whole code was patched against server error log entries
Changes in version 1.5 (November 2013)
-> Added 'previous' and 'next' buttons in preview mode to easily flip through a whole album
Changes in version 1.4.1 (November 2012)
-> removed tiny bug in 'renaming album' script
Changes in version 1.4 (November 2012)
-> Long album names can be displayed now
-> Albums can be renamed and merged
Changes in version 1.3 (November 2012)
-> Minor code fixes
-> Enhanced comment spam potection: You can now set "blacklisted words" in the configuration file
Changes in version 1.2 (June 2012)
-> Replaced functions that were declared as DEPRECATED since PHP 5.3
Changes in version 1.1 (October 2008)
-> Bugfix: Some comments could not be deleted
-> Changed comment design
-> Added spam protection
-> Possibility to deactivate commenting
-> Captions can be displayed at the index
Changes in version 1.0 (June 2008)
-> Possibibility to use GIF and PNG files aswell
-> Possibility to set an image caption and title as an admin
-> Design changes
Changes in version 1.0 beta (June 2008)
-> Added features:
-> Admin-area feature:
* Deletion of single comments
* Deletion of single pictures
* Deletion of albums
* Uploading images (you can aswell disable it in the config file)
-> User features
* Displaying of number of comments available at picture index
* Displaying of comments on multiple pages (number is configureable)
* Possibility to disable displaying of exif in config file
* A few other small handy improvements, e.g. "intelligent" back-links.
Changes in version 0.7 (June 2008)
-> Optical changes, corrected some optical errors
Changes in version 0.6.1: (February 2008)
-> Bugfix: it was possible to include files outside the "lang" directory by manipulating Cookies
Changes in version 0.6: (February 2008)
-> Added support for use of multiple languages
-> Small bugfix to the commenting function
Changes in version 0.5: (Xxxxxx ????)
-> Multiple pages function added
-> Changed preview layout
-> Some bugfixes
Changes in version 0.4: (Xxxxxx ????)
-> small performance improvement
Changes in version 0.3: (Xxxxxx ????)
-> added preview mode
-> added displaying of EXIF information
Changes in version 0.2: (Xxxxxx ????)
-> thumbs in index were not centered vertically
-> changed layout for added comments
Changes in version 0.1 (to initial release): (Xxxxxx ????)
-> added icons
-> use of different directory for thumbs and comments
