Picturo 2.0

About the Application

Built on top of Picturo, Picturo2.0 is a stupidly simple, blazing fast, flat file photo cum Album gallery running. No admin, you just need to drop your Pictures and Albums in the content to publish your pictures. Picturo is heavily inspired by Pico, but it’s for Photos and Albums.

Demo

You can try Picturo2.0 at Demo, actually the demo is private but you can login with the following credentials :

Admin Account:

user : admin
password : admin

User Account:

user : toto
password : admin

Screenshots

Requirements

To run Picturo2.0 you will need PHP 7.1.3+, Twig 2.x (needs at least PHP 7.1.3 to run) and GD Library on your server. If you’re running Apache you will also require mod_rewrite to be enabled.

Installation

First download Picturo2.0 and extract it on your server. Change ownership and permission of the cache folder to the user of your web server set permissions to 777 so you’ll be able to delete cache if needed.

Test Server

Upload your folders of pictures into content.

Customize settings by editing config.php in the root folder of Picturo. To override a setting simply uncomment it in config.php and set your custom value.

Privatize your site

Picturo2.0 can keep your galleries private, you just have to edit config.php and set private variable to true and add a user. By default, there is an admin user with the password “admin” in the configuration file. Just uncomment the two following lines to enable private galleries :

$config['private'] = true;
$config['admin_pass']['admin'] = 'sha512:1000:2Gp+SOuwkWQpMsemFvMyxfPtEfY/M77l:GrHLycEBPATCSmFCmd4onEynvfSoNR3Q';
$config['private_pass']['user'] = 'sha512:1000:2Gp+SOuwkWQpMsemFvMyxfPtEfY/M77l:GrHLycEBPATCSmFCmd4onEynvfSoNR3Q';

Passwords are SHA-1 strings, you can generate your passwords online here at sha1-online.

Add galleries

Your photos must be stored in content folder, if you want to add a gallery you just need to create a folder within your content folder. Galleries thumbnail are generated with the first picture found in the folder.

Create your own theme

Picturo2.0 supports themes with Twig as templating engine they are located in the themes folder. All themes must include two files :

gallery.html
detail.html

If you want to keep your galleries private, you will need a third file “login.html”. Each file will have a basic set of variable, plus specific variable.

Default variables, available for all files :

{{ base_url }} : The URL of your site
{{ theme_url }} : The URL of your active theme
{{ site_title }} : The title of your website
{{ username }} : The logged in username (if you use private gallery)

Variables for gallery.html, which will list all folders and pictures :

{{ url }} : The current url
{{ breadcrumb }} : An hash containing a splitted array of URL. Keys are URL and values are folders name
{{ folders }} : An array containing folder objects for current url. Each folder has 3 attributes (url, thumbnail_url, name)
{{ images }} : An array containing image objects for current url. Each image has 3 attributes (url, thumbnail_url, name)
{{ page_count }} : The total count of pages for current url.
{{ current_page }} : The current page

Variables for detail.html, which will display one picture :

{{ breadcrumb }} : An hash containing a splitted array of URL. Keys are URL and values are folders name
{{ image_url }} : The URL of the current image
{{ image_previous_url }} : The URL of the previous image
{{ image_next_url }} : The URL of the next image

Variables for login.html, which will display the login form :

{{ login_error }} : Tell if login attempt was valid or not
{{ username }} : The username entered in login form input

Thumbnail generation

For easy thumbnail generation in your theme, there is an helper function available in your views. You should use the function picturo_thumbnail in your views. For example, if you want to generate a squared 300px by 300px thumbnail, insert the following line in your view :

{% picturo_thumbnail(thumbnail_url, 300, 300) %}

Thumbnail will be automagically created in a folder matching the size of the thumbnail !

Other themes

I plan to release some others theme later, but if your want to create your own I recommend to check the default theme and use Twig template for easy theming. And please, show me your theme if you want to share it.

Contribute

Help make Picturo2.0 better by checking out the GitHub repository and submitting pull requests. If you find a bug please report it on the Issue page.

Developement Credit:-

[x] Original Author for Repository Picturo
[x] Modification Author for Repository Picturo
[x] Upgrade Author for Repository Picturo

2013-05-07 Pico Release V0.6.2

[x] [Changed] Replaced glob_recursive with get_files

Picturo is heavily inspired by https://github.com/picocms/Pico, but it’s for Photos and Albums.

2013.09.01 - v0.0.1

[x] Initial release

2013.09.19 - v0.1.0

[x] Refactoring : Using a new router
[x] Cleaning some urls
[x] Fixing bugs

2013.09.21 - v0.2.0

[x] Adding a thumbnail service

2013.11.08 - v0.3.0

[x] Better composer configration
[x] Refactoring : Creating basic controllers
[x] Updating default configuration
[x] Bugfix on default theme

2014.06.26 - v0.4.0

[x] Better authentification method
[x] Add ban functions to avoid spam (writen by Seb Sauvage at sebsauvage.net)
[x] Add administrator status
[x] Add multiple users
[x] Add possibility to hide folders to users via administration. By default, a new folder is available for all users.
[x] Administrator can manage pictures (rotate, cropped, cut, reduce, setWidth, setHeight). Modifications are made on thumbnails. Originals are not modified.
[x] Add error view
[x] Update theme (footer is always at the bottom of the page -not bottom of the screen- whatever the height of content)
[x] Pictures (originals) can be download one by one by users
[x] javascript preloader for big pictures
[x] generate method of thumbnail replace by auto_thumb method (writen by Bronco at warriordudimanche.net)
[x] pictures and folders are sorting with natural case insensitive sort

2020.10.16 - v2.0.0

[x] Translation for user friendly messages - English
[x] Composer Update for Twig
[x] Vendor dependency updated to Twig 2.8.x
[x] Media Query for Resolutions for Desktop and Mobiles

2020.10.17 - v2.1:

[x] Desktop Friendly theme (Support for Resolution 1024×600, 1024×768, 1280x600, 1280x800, 1280x960, 1280x1024, 1366x768)
[x] Support GIF (.gif)
[x] Support PNG (.png)
[x] Support BMP (.bmp)
[x] Support JPEG (.jpeg, .jpg)
[x] Mega Menu for Public session $config['private'] = false; i.e. Anonymous Users
[x] Mega Menu for Private session $config['private'] = true; i.e. Registered Users
[x] Private Albums (Album under a blank Album)
[x] User Friendly Error Messages
[x] User Friendly Language - English
[x] Added a new design for error view
[x] Update Vendor Directory for Bramus/router to use dev-master
[x] Update Vendor Directory for Twig to use v2.8.x
[x] Update Vendor Directory for Symphony to use dev-master
[x] Update Composer for external dependencies

v2.2

[ ] Support Other BMP Types (.dib, .rle)
[ ] Television Friendly theme (Support for Resolution 1440x900, 1600x1200, 1920x1080, 1920x1200)
[ ] Mobile Friendly theme (Support for Resolution 480x853, 600x960, 800x1280, 900x1280)
[ ] Add settings -> Add Users, Manage Users
[ ] Add new Themes with new Designs
[ ] Support TIFF (.tiff, .tif)
[ ] Support Other JPEG Types (.jpe, .jfif, .jfi, .jif)
[ ] Support TGA (.tga, .vda, .vst, .icb)
[ ] Support DDS (.dds)
[ ] Photo count for each Album
[ ] Changing Themes on the runtime by User
[ ] Convert all of the image types to a single image source (.jpeg/.png) while viewing on the Album

dineshkummarc / Picturo2.0

readme