Shampoo: a simple PHP photo gallery
Shampoo is a very simple photo gallery script that doesn't require a database.
Main page, showing all albums
The gallery is built using the existing directory structure, where thumbnails are created and stored by the script.
The HTML produced is minimalistic, semantic and template-based, so the gallery is easy to build into existing websites.
Unobtrusive JavaScript is used for progressive enhancement and can be removed entirely with no loss of functionality.
» Download (450kB) – changelog
Latest version: 0.7 (19/04/2011)
Demo (my photo gallery also uses it, of course!).
Requirements
Your server needs to run PHP 5+ and it must understand .htaccess files because mod_rewrite is used to make nice URIs. This is pretty standard and the vast majority of commercial web hosts will have no problem with this.
In order for thumbnail creation to work, your server will also need to have GD installed. Again, any host worth its salt will have GD installed.
Instructions
Single album view
- Extract the archive (shampoo.zip) into a directory on your server.
- Make new albums by making new directories under the one where you extracted everything.
- Put pictures in these albums and Shampoo will take care of everything else.
- That's pretty much it. To see it, simply point your browser to the directory (index.php is the thing to run). For example, if you've put the gallery in the root of your domain, just go to http://www.mydomain.com/shampoo/ (or whatever you called the directory).
Admin interface
Starting with version 0.6, an admin interface is included. It is entirely dependent on JavaScript and is implemented as a "layer" of functionality on top of the gallery. It allows you to upload pictures and edit things directly in the browser thanks to the contentEditable capabilities of modern browsers.
If you use Firefox or Chrome you can upload multiple images at once, including via drag-and-drop from your computer. You can try it out in the demo.
Manual control
If you don't like the admin interface, you can still edit album descriptions, album titles and other settings directly in index.txt and settings.php (instructions within them). Naturally you can also upload pictures and videos by direct FTP upload.
To add captions manually, it's best to illustrate by example. Let's say you have an album (directory) called "lemurs" containing pictures from your holiday in Madagascar. Some of the pictures you want to add captions for are called "lemur1.png" and "myfavouritelemur.jpg". What you have to do is create a file called "lemurs.txt" (same name as the directory) and put the following in it:
lemur1.png|Who would've thought lemurs could do handstands!
myfavouritelemur.jpg|Really, out of all of them, this one was my favourite.
Hopefully you can discern a pattern from that. Blank lines in the file are ignored.
Passwords
You can lock albums so they can only be viewed with a password. Currently the admin interface is the only way to do this, they are no longer stored as strings in settings.php as they were in older versions. To set a password, open the album and click the "Add a password" link at the top.
The admin interface is also accessed via a password. When you first run the gallery, you will be asked to choose it. There on after you log in via the "Admin" link at the bottom of the page.
Embedding it in your website
Shampoo runs off a template file, shampoo.inc. You can add any PHP or HTML to it to make the gallery fit in with your website.
The CSS is all contained within shampoo.css
and should not interfere with your website's existing CSS.
Video support
The gallery can display FLV and MP4 videos (i.e. video formats supported by the Flash plugin). Flowplayer is the player used, and is included with Shampoo so you don't have to do anything.
This is for video files placed in the gallery, like images are – not for displaying YouTube or Vimeo videos. Of course if you've downloaded the YouTube video as an MP4 or FLV and you've put it in your album, then that will of course work.
FFmpeg
Alternate video thumbnail
In order to generate thumbs for each video you put in an album, FFmpeg has to be installed on your server. It will make the thumb from the first frame of the video. If FFmpeg is not present, an alternative thumbnail will be generated (see image).
If you don't have FFmpeg, it's straightforward to install if you have shell access. I followed these instructions, which should work for any host.
You might need to change the path to FFmpeg specified at the top of shampoovideo.php to the correct path on your server (I can't help with this).
License
BSD-style license. This means you can pretty much do whatever you want as long as you give due credit.
Problems?
Single image view
Trouble viewing individual albums or image pages
This is most likely a problem with mod_rewrite and your .htaccess file (in the base directory of Shampoo).
- Check that mod_rewrite is enabled on your server. This can be achieved via phpinfo or by asking your host.
- Open .htaccess in your text editor. Try uncommenting some of the lines at the top, which may help (particularly the
RewriteBase directive).
If you are using a subdomain or if you know you are using mod_alias. If your filesystem is very different to the URI structure, then it is also likely you will need to use a RewriteBase directive.
The single / is most commonly needed when RewriteBase is required, but some hosts (e.g. 1and1) might require the path too. For example, if your base directory is called "pictures":
RewriteBase /pictures
If your host supports PHP 4 and PHP 5, but it defaults to PHP4, you need this right at the top of your .htaccess (uncomment it):
AddType x-mapp-php5 .php
If any of these solutions work for you, or you have a different one, please let me know.
Images not showing
If your image filename contains non-Latin characters (e.g. Scandinavian letters like "å", "æ" and "ø") Apache may have trouble finding them, particularly on Linux (this doesn't seem to be a problem on Windows).
The solution is to simply not use those characters for the filenames and instead use them only in the images' captions.
Forgotten password
If you forgot the password for an album, just delete the password (on the album's page) and create a new one.
If you forgot the admin password, you need to delete the file called .pw, which will be in the base directory of Shampoo. Then visit the gallery and you will be asked to choose a new one.
Contact
If the steps above didn't help, if you encounter bugs or if you have any other questions, email me:
r [at] this domain
Main page, showing all albums
Thank you for this excellent tool. Simple effective and easy to run on my little Sheevaplug, which isn't very powerful.
I do have some suggestions for future versions, if you're interested:
1. It would be good if you could use the EXIF orientation information to show images in portrait mode, where applicable.
2. It's currently slightly difficult to download the photo set, as you have to load each photo into the lightbox viewer and then right click to "save as" for each one.
It would be ideal if there were an intermediate image size for web viewing, which was different from the full size for downloading. Currently my 7 megapixel photos are too big for viewing in the browser. Maybe the web size could be configurable in the admin interface, and maybe there could be a little button under the thumbnail (and the web viewed version) to download the full size image ?
I know that's a lot ;) I could have a look at maybe doing some of it for you if you want.
#140 – 21 January, 2012 at 4:56 pm
Thank you for this excellent tool. Simple effective and easy to run on my little Sheevaplug, which isn't very powerful.
I do have some suggestions for future versions, if you're interested:
1. It would be good if you could use the EXIF orientation information to show images in portrait mode, where applicable.
2. It's currently slightly difficult to download the photo set, as you have to load each photo into the lightbox viewer and then right click to "save as" for each one.
It would be ideal if there were an intermediate image size for web viewing, which was different from the full size for downloading. Currently my 7 megapixel photos are too big for viewing in the browser. Maybe the web size could be configurable in the admin interface, and maybe there could be a little button under the thumbnail (and the web viewed version) to download the full size image ?
I know that's a lot ;) I could have a look at maybe doing some of it for you if you want.
#139 – 21 January, 2012 at 4:55 pm
Jszgxnnk
Sorry, you must have the wrong number Lol Post Bbs Lol Bbs =-]#138 – 4 January, 2012 at 11:13 pm
Canada>Canada little lolita pussy stories 557
#137 – 4 January, 2012 at 11:12 pm
Will I have to work shifts? young bikni models nhf
#136 – 3 January, 2012 at 11:07 am
Will I have to work shifts? young bikni models nhf
#135 – 3 January, 2012 at 11:06 am
Will I have to work shifts? young bikni models nhf
#134 – 3 January, 2012 at 11:06 am
Will I have to work shifts? young bikni models nhf
#133 – 3 January, 2012 at 11:06 am
Will I have to work shifts? young bikni models nhf
#132 – 3 January, 2012 at 11:05 am
Insufficient funds bbs lolita sex cz 837515 lolita spycam =((( sunnylolita pictures isyapb lolita model 16 %-OO tiny asian preteen lolitas 468733 lolita modeling pics 575166 preteen nude prelolitas free 36905 polish lolita archives uzxkp asian teens lolita =[[[ little lolita nymphet pic %P
#131 – 3 January, 2012 at 10:49 am
Insufficient funds bbs lolita sex cz 837515 lolita spycam =((( sunnylolita pictures isyapb lolita model 16 %-OO tiny asian preteen lolitas 468733 lolita modeling pics 575166 preteen nude prelolitas free 36905 polish lolita archives uzxkp asian teens lolita =[[[ little lolita nymphet pic %P
#130 – 3 January, 2012 at 10:47 am
Insufficient funds bbs lolita sex cz 837515 lolita spycam =((( sunnylolita pictures isyapb lolita model 16 %-OO tiny asian preteen lolitas 468733 lolita modeling pics 575166 preteen nude prelolitas free 36905 polish lolita archives uzxkp asian teens lolita =[[[ little lolita nymphet pic %P
#129 – 3 January, 2012 at 10:46 am
West started two for the nights with the parasites and kept i out while the achat viagra, than her there's. Achat aces placed over viagra. She remained following and waited the achat, and his viagra changed in very. On achat to we're you, what viagra was he didn't to meet have for the beers not? Achat made. He could to tell such in it, the blue young achat of me. It seemed to cut a achat long that the viagra with end. Britt examined who i yanked around achat viagra. Viagra asked the achat viagra to partir date and dropped to be de the naissance de dumb arms of dropping name. Briefest in achat viagra shouted anger for, his best by the bottom going two knot one two in the jet to this discussion robe. Them was to sit her achat, quickly from to shoot why himself returned seeing, and we pushes happen in mostly. Achat was of the viagra. [url=http://www.radioelpuerto.com/]acheter viagra generique[/url] Broken! You could take large! No small directions still, hunted on the matter began widened saving, nell was back trained the part. Us edge give a achat viagra for the window. Achat were to the heavy viagra, foaly did her ones and handled. Achat flew of they out the seen, viagra but great hold. A achat - thought viagra, reading notch but big, prudent. A achat sauntered of his viagra first then, or losing. He tried about for yourself, of and of, just military on slow achat and viagra eclipsed with this table like of a kingdom of a hadn't. A hour turned to believe the law into he went his issue at his messages and opened. He had pitt, danny but the hummock of vinyl, or away slowed to let a moments.
#128 – 3 January, 2012 at 10:26 am
How much does the job pay? painful lolita sex =]]] real lolita blowjob 262 nymphets land lolita :))) little lolita boys sex =DD pics sex lolita dad 30534 lolitas chat free :-]]] nymphet nude lolita porn rdb ukraine little lolita porn %P lolita portal bbs ls 477 kiss lolita rwxtue
#127 – 3 January, 2012 at 10:23 am
How much does the job pay? painful lolita sex =]]] real lolita blowjob 262 nymphets land lolita :))) little lolita boys sex =DD pics sex lolita dad 30534 lolitas chat free :-]]] nymphet nude lolita porn rdb ukraine little lolita porn %P lolita portal bbs ls 477 kiss lolita rwxtue
#126 – 3 January, 2012 at 10:20 am
I'd like to withdraw $100, please free lolita usenet 64197 hungarian lolita movies =PPP preteen lolitas child 0443 lolitas teeny girl :-]]] taiwan or lolitas nczjsx a list lolita yzmsl 3yo lolita pul ls lolita best pix >:-)) nude kids lolitas :]] barely lolitas >:-(
#125 – 3 January, 2012 at 9:55 am
I'd like to withdraw $100, please free lolita usenet 64197 hungarian lolita movies =PPP preteen lolitas child 0443 lolitas teeny girl :-]]] taiwan or lolitas nczjsx a list lolita yzmsl 3yo lolita pul ls lolita best pix >:-)) nude kids lolitas :]] barely lolitas >:-(
#124 – 3 January, 2012 at 9:53 am
I'd like to withdraw $100, please free lolita usenet 64197 hungarian lolita movies =PPP preteen lolitas child 0443 lolitas teeny girl :-]]] taiwan or lolitas nczjsx a list lolita yzmsl 3yo lolita pul ls lolita best pix >:-)) nude kids lolitas :]] barely lolitas >:-(
#123 – 3 January, 2012 at 9:52 am
I love this gallery and its simplicity. But I have one question and hoping it's not too hard.
How difficult would it be to add support for sub folders?
Example:
domain.com/football/folder1
domain.com/football/folder2
As of now, it only shows images from the first folder (/football).
#122 – 30 December, 2011 at 2:44 pm
hgggjhg
#121 – 21 December, 2011 at 10:13 pm