Gallerina Instructions

Welcome

Gallerina is a minimalist open source PHP gallery CMS for presenting images.
It is ideal as an artist's simple online portfolio.

Install

Unzip Gallerina.zip and upload contents to your server.

Gallerina.zip package contents:

Create Project

Create a folder inside the gallery-projects folder.
Name your project folder whatever you like.
Place images inside your project folder.


Add Project Cover Image

Create a folder named cover inside your project folder.
Place the cover image inside this folder.
Your project will be displayed even without a cover image.


Add Project Details

Create a text file named about.txt inside your project folder.
The first line of this text file will be displayed as the project title.
The second line will be the subtitle.
The third line, and any succeeding lines, will be the description of the project.
You may use HTML in the description, and line breaks are automatically formatted.
Your project will be displayed even without these details.


Project Display

By default, a project displays the full-sized images.
The images are displayed in alphabetical order by filename.
You can change the the display format by adding image details or thumbnails.
To specify the display order and/or display the details for each image, add image details.
To display thumbnails that link to the full-sized images, add thumbnails.


Add Image Details

Create a text file named image-descriptions.txt inside your project folder.
List the details for each image in this format:
imagefilename1.jpg|Title|Description
imagefilename2.jpg|Title|Description
imagefilename3.jpg|Title|Description

Keep each image's details on a single line.
Use gallery-utility-list.php to make this task easier.
You may use HTML in the description.
Use <br /> tags to add line breaks within the description.
The images will be displayed in the order you list them.
If the image is not listed in this file, it won't be displayed.
When you update images in this project, remember to update image-descriptions.txt.
Return the project to default display by deleting or renaming image-descriptions.txt.


Add Thumbnails

Create a folder named thumbnails inside your project folder.
Create a thumbnail for each image and place it inside this folder.
Thumbnail must have the same filename as the full-sized image, but with a _ at the end:
If your full-sized image is picture.jpg, its thumbnail must be picture_.jpg.
Use a batch resizing software (Photoshop can do it) to make this task easier.
All images in this project must have a corresponding thumbnail.
When you update images in this project, remember to update the thumbnails too.
Return the project to default display by deleting or renaming the thumbnails folder.

Gallery Title & Description

Edit about-gallery.txt inside the gallery-projects folder.
The first line is the website title.
The second line is the title displayed on the main gallery page.
The third and any succeeding lines are the description displayed on the main gallery page.
You may use HTML in the description, and line breaks are automatically formatted.


Gallery Display

The main gallery page displays the gallery title, gallery description, and a list of projects.
Each project is listed with a cover image, title, and subtitle (if these are provided).
If no cover image is provided for a project, a solid colored box appears as its cover.
By default, projects are listed in alphabetical order by project folder name.
To specify the display order of projects, add a project list.


Add Project List

Create a text file named list-projects.txt inside the gallery-projects folder.
In the text file, list the project folder names in the order they should be displayed.
One project folder name per line, for example:
project-1
project-2
project-3

Use gallery-utility-list.php to make this task easier.
If a project folder is not listed in this file, it won't be displayed.
When you add or remove projects, remember to update list-projects.txt.
Return the main gallery page to default display by deleting or renaming list-projects.txt.

Tips

Curating content

Quality over quantity.
Nothing is stopping you from creating a hundred projects with five hundred images in each, but since there is no pagination system that would be impractical.
Gallerina is designed to help you showcase your best work - it was not built to handle large numbers of files and folders.


Organizing content

Decide on the best way to sort your work into projects.
Depending on the kind of work of you do, you may sort by year, medium, style, client, etc.


Naming files and folders

Use only letters, numbers, dashes, and underscores. No punctuation and no spaces.
Be descriptive and specific, but concise and systematic.
This helps people find your work via search engines, and also helps you stay organized.
Example project folder name: 2012-exhibit-landscapes instead of project1
Example image name: drawing-tree.jpg instead of D001.jpg


Image size

Full-sized images are displayed by default, so keep them at a reasonable height and width.
Around 1000 pixels maximum width and 800 pixels maximum height would be ideal.


About

Gallerina / March 2012 release
Coded by Feanne using PHP 5.3.8 on the built-in Apache 2.0 on Mac OS X Snow Leopard.
Stylesheets based on Boilerplate CSS Framework.
Lightbox effect using jQuery.
Author's Note:
I created Gallerina for my own online portfolio, I hope you find it useful too. :)
This is my very first attempt at creating a CMS, it's far from perfect, and may be more useful as a starting point than a finished product - use at own your risk, and enjoy!