_________.__ .__ .__ ________ / _____/| |__ |__| _____ _____ |__| ____ \_____ \ \_____ \ | | \ | | / \ / \ | |_/ __ \ / ____/ / \| Y \| || Y Y \| Y Y \| |\ ___/ / \ /_______ /|___| /|__||__|_| /|__|_| /|__| \___ >\_______ \ \/ \/ \/ \/ \/ \/
This is the main branch of Shimmie, if you know anything at all about running websites, this is the version to use.
Alternatively if you want a version that will never have significant changes, check out one of the versioned branches.
- MySQL/MariaDB 5.1+ (with experimental support for PostgreSQL 9+ and SQLite 3)
- PHP 5.4.8+
- GD or ImageMagick
- Create a blank database
- Unzip shimmie into a folder on the web host
- Visit the folder with a web browser
- Enter the location of the database
- Click "install". Hopefully you'll end up at the welcome screen; if not, you should be given instructions on how to fix any errors~
Upgrade from 2.3.X
- Backup your current files and database!
- Unzip into a clean folder
- Copy across the images, thumbs, and data folders
shimmie.conf.phpto use the new database connection format:
$database_dsn = "<proto>://<username>:<password>@<host>/<database>";
The rest should be automatic~
If there are any errors with the upgrade process,
be left in the config table and the process will be paused for the admin
Deleting this config entry and refreshing the page should continue the upgrade from where it left off.
Upgrade from earlier versions
I very much recommend going via each major release in turn (eg, 2.0.6 -> 2.1.3 -> 2.2.4 -> 2.3.0 rather than 2.0.6 -> 2.3.0).
While the basic database and file formats haven't changed completely, it's different enough to be a pain.
Various aspects of Shimmie can be configured to suit your site specific needs
via the file
data/config/shimmie.conf.php (created after installation).
Take a look at
core/sys_config.inc.php for the available options that can
Custom User Classes
User classes can be added to or altered by placing them in
For example, one can override the default anonymous "allow nothing" permissions like so:
new UserClass("anonymous", "base", array( "create_comment" => True, "edit_image_tag" => True, "edit_image_source" => True, "create_image_report" => True, ));
For a moderator class, being a regular user who can delete images and comments:
new UserClass("moderator", "user", array( "delete_image" => True, "delete_comment" => True, ));
For a list of permissions, see
ui-* cookies are for the client-side scripts only; in some configurations (eg with varnish cache) they will be stripped before they reach the server
- shm-thumb = outermost element of a thumbnail
- shm-toggler = click this to toggle elements that match the selector
- shm-unlocker = click this to unlock elements that match the selector
- shm-clink = a link to a comment, flash the target element when clicked
Please tell me if those docs are lacking in any way, so that they can be improved for the next person who uses them
#shimmie on Freenode
Email: webmaster at shishnet.org
Issue/Bug tracker: http://github.com/shish/shimmie2/issues
All code is released under the GNU GPL Version 2 unless mentioned otherwise.
If you give shimmie to someone else, you have to give them the source (which should be easy, as PHP is an interpreted language...). If you want to add customisations to your own site, then those customisations belong to you, and you can do what you want with them.