By Alford Deeley aka
machinari
Last updated: Sept 10, 2005
If you're reading this, I'm sure you've realized by now what Inmemoriam is--a media gallery plug-in designed specifically to run inside of Geeklog making use of Geeklog's user database as well as many of its core functions.
Inmemoriam Media Gallery for Geeklog was inspired by a combination of factors not the least of which are both Geeklog's need for an integrated gallery solution designed with Geeklog in mind, and my personal preference for something other than the current mainstream options. My name is Alford, and I hope you enjoy using Inmemoriam as much as I've enjoyed developing it. Does that ever sound like a commercial :P
contents
- Inmemoriam supports multiple albums and sub-albums.
- Users can create their own albums and make submissions to other albums.
- Submissions to albums can be moderated.
- Various email notifications.
- Supports audio, video, and various document types as well as images.
- Support for various media types is configurable per album.
- Maximum filesizes are configurable per album.
- Multiple views per image.
- Full views may be restricted.
- Client side sorting.
- Slide show.
- Individual media items can be rated.
- Users can leave comments per media item.
- Comments and the rating system may be disabled per album.
- Inmemoriam supports titles and captions for media, as well as names and descriptions for albums.
- Search keywords are also available for media items.
- Standard array of Geeklog block integrations.
- A featured album may appear variously on Geeklog's index page.
- Random image block.
- Style and layout are easily modified via style sheets and template files.
- Users may add existing media to their own 'My Favorites' album.
- Inmemoriam supports watermarking.
- Inmemoriam albums are stored outside the web root helping to prevent "hot swapping."
- Supports FTP uploads.
- Inmemoriam is database driven.
- Makes use of various Pear image manipulation classes.
- Supports the GD, ImageMagick, and NetPBM image libraries.
- Configurable image options allow for a combination of static and/or 'on the fly' image generation.
- User restrictions/permissions may be applied to individual media or album wide.
- Individual albums may be 'skinned' using CSS themes.
- Configure the display of Geeklog's left and right blocks for Inmemoriam pages.
- Various RSS feeds including: all albums; per album; and a new comments feed.
- Autolink/autotag support options.
- Special user groups are supported--see permissions.
- ...and oh, so much more!
- Inmemoriam blocks
- The random media block is what the name suggests. It presents a thumbnail image chosen
randomly from the database. It also incorporates a small and dynamic list of links to help get
around the gallery. It can be enabled/disabled from the Inmemoriam admin panel or from your
Geeklog blocks admin panel.
- The featured album center block offers two types of album displays that can be made to
appear on your Geeklog index page (though not at the same time): an album summary; or a thumb review.
The album summary displays a statistical summary of the albums contents along with a representative
and configurable thumbnail. The thumb review presents a configurable number of thumbnail images, which
represent the featured album. This feature can be enabled/disabled and configured from the album editor.
- Geeklog Integration
- Inmemoriam offers a standard array of Geeklog integrations including the what's new block,
the stats block available from the stats page, the profile block available in a user's
profile. Inmemoriam is also integrated into Geeklog's search functions.
- Browsing albums: Any features available to users will display themselves on the main Inmemoriam index page.
Once you've passed the splash page, which can be disabled, you are presented with a list of album summaries
that represent top-level albums. Each summary lists stats for that album as well as links to available album
features, e.g., an add and/or an edit link might appear. Clicking on the browse link, or the album thumbnail,
or the album title will direct you to the album's thumbnail page.
The thumbnail page contains all of the that albums thumbs as well as summaries for any sub-albums that it may contain.
- Sub-albums: Sub-albums are displayed similarly to top-level albums, but with one difference: sub-albums only appear as
summaries on the top-level album page to which they belong.
- Browsing media: Once you have entered an album, clicking on any thumbnail will display a larger size version of that
image along with a number of configurable features.
- A rating system is available in order for users to vote on a scale of 1-10.
- The Geeklog comment engine is available for users to leave comments.
- An image's EXIF data can be read and displayed if the image supports that function.
- In addition to the larger image available on the current page, a user can click a link to view the original
and full size image.
- Note: most of these features can be restricted and somewhat configured.
- An easy to follow "bread crumb" exists in the block header of any browse page.
- If you prefer to view an album's images without having to click the "next" button every time you want
to advance, then clicking the "slideshow" link will allow you to view the images as they scroll automatically
at a chosen delay rate. The slideshow page is removed from the Geeklog layout, which allows a greater freedom to theme.
- The "my favorites" album offers a user the opportunity to store any preferred images while browsing.
It is accessible from the link appearing underneath the larger size image while browsing media and also from the
random image block if the album is not empty. This feature is only available for logged-in users.
- A top ten (rated) list of thumbnails is also available from the random media block. This list may also be
viewed from the Geeklog stats page.
- A most popular (by views) album is similarly available.
- 6 themes are available: default; shade; light; rose; bluethunder; and yellowcascade. The default theme really isn't a
theme at all. Rather it is meant to reflect the site's currently displayed Geeklog theme. This is accomplished by
using transparent colors and relative font sizes, etc. The other 5 themes are basically color highlights,
borders, and background colors here and there. The framework exists for talented designers, using these themes
and their integration, to create wonderful looking galleries.
- Theme previews:
Default
 |
Light
 |
Shade
 |
Blue Thunder
 |
Yellow Cascade
 |
Rose
 |
- At the moment "picture frames" are not implemented. I've made the decision to
allow themes the work of frames via CSS. Faster load, less hassle. This may change in future releases.
- If users have been allowed, the album editor is made available to create and/or edit new
and/or existing albums. The editor is divided into four major sections:
- Choose an album to edit or name a new album near the top of the editor. The ID field
contains the directory name on the server in which the album's media will be stored. This ID field is
editable, but it really makes no difference as nobody sees this value. I really should disable it
It's more for reference sake.
- From this page you have the option to make your album a top-level album or a sub-album of an
existing top-level album.
- The maximum upload file size may be set here. It cannot/will not exceed that maximum size already
set by the gallery admin in the admin panel.
- Inmemoriam supports various audio, video, and image formats, as well as various document types.
These media types can be enabled/disabled per album from the album editory. To configure exactly
what formats are supported, see Inmemoriam's config.php file. Supported formats within allowed media
types will be displayed in the media editor when you are uploading media.
- The access rights section of the editor offers similar
restrictions as those for Geeklog stories.
- Read and/or edit rights can be set for an album's owner or a particular group.
Further, read access can be enabled/disabled for logged in members and anonymous users. These
options are available for gallery administrators only.
- The ability to turn on the submission queue is available to album owners. With the queue turned on,
any submissions made to the album from users other than the owner are placed in the queue until that
submission has been approved. Submissions can be approved by album owners or by gallery administrators.
- If submissions exist in the queue, a link to the queue will appear in the album owner's "user
functions" block.
- Album display settings include settings for the featured album center block, the album theme,
a representative album thumbnail, as well as the default configuration for the thumbnail page. Oh,
and of course you can supply a description for the album here as well.
- You can upload an image or allow the script to choose at random an image from the
album to represent the album in its summary on the album index page.
- The number of thumbnails and their default order can be set here for the album's
thumbnail page.
- Setting an album as featured will disable any other album from being featured. This option
is only available for gallery administrators. 2 types of album summaries are available for
the center block: a statistical summary with a thumbnail--this is the same as the album summaries
that you see on the album index page; or a thumb review, which simply displays some number
of the latest thumbs in a row. The number of thumbs displayed in the thumb review is set from
the admin panel for the sake of the site's global layout.
- Setting an album theme will cause a corresponding style sheet to load whenever that album
is displayed.
- Media display settings apply to that page you are directed to once
you've clicked on any thumbnail.
- Enabling/disabling the comment engine or the rating system determines whether that function
will appear on the page with the scaled version of your image.
- The default display size refers to the size of the box that the image will fit into when any image in
that album is being viewed. This does not affect the size of the original, nor will the original
be enlarged if the size of the box is larger than the original.
- Inmemoriam also offers you the ability to restrict access to the original image. You can restrict
access to all users by disabling the feature altogether or to logged-in members. Alternatively,
you can also restrict an image's full view only to members of a particular group. This is a group that
you would create from Geeklog's group admin page. When creating the group you will need to add
the "inmemoriam.fullview" permission to this group, and then you need to add users
to this newly created group of course.
- If any images in the current album are set to display with a watermark, you have the option from this screen to
disable all those watermarks at once. All images in the gallery will now display without watermarks.
Watermarks may also be disabled per media item from the media editor.
- The option exists to apply all relevant display settings to any sub-albums that exist under a top-level album.
Applicable settings include: theme; maximum display; thumbnail number and order; comments; ratings;
and full-size image restrictions.
- Warning: Deleting an album will remove the album,
any sub-albums that are assigned to it, and all media that belongs to any of those affected albums.
No confirmation is required so careful what button you click!
- The media editor is available for media owners and gallery administrators.
- The access rights section of the editor offers similar restrictions as those for the
album editor.
- The media editor offers you the ability to include a title and a caption with your
media item. Note: The caption is not displayed during thumbnail view.
- You can also specify "keywords" for your media that will be used by the Inmemoriam search functions.
- Note: HTML is not supported in any field with the exception of line breaks (<br> or <br />) and
anchors (<a>) in the caption field.
- Inmemoriam supports the display of exif data if it is applicable to your media. When enabled, a link
becomes available that will open a small popup window containing a brief of the exif data.
- Inmemoriam supports watermarking images in a limited fashion.
A wider range of watermark functions are planned for future releases.
- Watermarking an image serves a number of purposes, not the least of which is to help
deter image copying. That is its main goal in Inmemoriam as the watermarks are being applied
to images as visible watermarks rather than invisible ones. An invisible watermark would
be more suited for owner copyrights or company details, even URLs.
- You may upload a file to be used as a watermark or you can use Inmemoriam's default watermark. If
you choose to use your own file, it must be a png-8 format file (png-24 is supported by Inmemoriam, but the GDlib
has a bug or three... I've also had success with png-32).
For a brief tutorial on how to create your own watermark image please see the included
tutorial page contributed by
Jill Costello (s_witch).
- Alternatively, a text watermark can be applied to images by specifying text in the appropriate box
or by selecting one of the prefab text marks. The font used for these "labels" is specified
in Inmemoriam's config.php file.
- Watermarks can be positioned according to available options. The size option is applicable to the text
watermark only: small will produce either a 12 pixel or a 12 point font depending upon your system; medium
will produce a 16 pixel/point font; and large will produce a 24 pixel/point font. You may also set the
image watermark's opacity.
- The option exists on the media editor page to apply a watermark and its settings to all images
in the current album or all images in every album. This is available for admin only.
- Warning: At the moment, using NetPBM or ImageMagick to
accomplish image watermarking WILL generate errors or even overwrite your original images. These issues
are being slowly rectified.
- Other issues not yet resolved:
- Special characters will cause errors when using ImageMagick to create text watermarks.
- Though the text watermark functions for all three image libraries, NetPBM employs the pnmlabel binary,
at the moment, which doesn't allow a font to be specified. Therefore, the resulting text doesn't look so hot.
- Later releases of Inmemoriam will see a wider range of image manipulation functions becoming available
from the media editor. See image handling for more information.
- Adding media via FTP is as easy as your FTP client makes it. Your Inmemoriam install document
provides you with information regarding the location of your albums on the server. Simply upload your
media to that album directory keeping in mind the directory structure outlined here:
- $INM_CONF['path_albums']
- top-level albums
- media items
- sub-albums
- media items
- Support for an unlimited depth of sub-albums is planned for a future release.
- Note: Directory names do not reflect album names, which can be set from the album editor after the album has
been included in the database.
- Once you have uploaded your media, login to your site as admin and visit the Inmemoriam admin panel at
$_CONF['site_admin_url']/plugins/inmemoriam/index.php
and click on the "directories" link once you are there. You are presented with the ability to
scan your album directories for any media that is not already in your database and given the opportunity
to add it either automatically or manually.
- Adding media via the media editor is just as easy as using FTP, but with one
major downfall, i.e., if you do not have sufficient permission you will only be allowed to add one item per submit.
If you have "inmemoriam.admin" rights or if you are the album's owner, then you will be presented with
an "add more" button allowing you to add multiple media items.
- Note: when adding multiple media items via the media editor the title and caption will only be applied to
the first image uploaded. The rest will have to be edited once in the database. If a watermark image is specified
then it will be applied to all items uploaded.
- See below for information about the moderation queue.
- The permissions editor, appearing for gallery admins only, is similar to that which is available for admins from
the poll editor, the story editor, the block editor, etc. For a brief overview, see the album
access portion of this document.
- The permissions editor is available per media item as well as per album. The implication is that any permissions
set on any media item, sub-album, and/or top-level album may be overridden by a more restrictive permission set on any
member of that family. For example: if I have an album full of unrestricted media items, i.e., images that even anonymous
users may view, but they are set in an album restricted to logged in members, the result is that those images will not
be accessible to anonymous users. And vice versa: if an image has been restricted to logged in members it will remain
restricted and inaccessible though it is found within an unrestricted album.
- Access can be determined also by using "groups." Inmemoriam offers a number of access levels available
to preexisting or newly created groups:
- inmemoriam.admin is granted to the root group when the gallery is installed. If you want other site users to
be able to administer your gallery, add this right to a group that the user is already a member of, or create a new
group having this right and simply add your desired users to it. You could also add this right to a particular user
without actually creating a new group. The same process applies for other rights in this list.
- inmemoriam.create will grant a group/user the right to create albums, even when the option to dissallow
logged-in users from creating albums is set.
- inmemoriam.add will allow a group/user to add media though that function is disabled for any users not belonging
to that group.
- inmemoriam.fullview offers the ability to view a full size image even when that option has been
restricted accordingly.
- inmemoriam.view offers generic access to the gallery when gallery access has been restricted entirely.
- Note: These security features have not been tested to their
potential. If you encounter an issue, send me an email and I
will respond with a fix as soon as possible. Alternatively, if you make use of these security features
and find them to be functioning well, please let me know.
- In keeping with Geeklog's philosophy of secure content management, Inmemoriam strives to provide an equally
secure environment for your site's media content. To this end Inmemoriam stores media outside of the web root
making it inaccessible to the public via normal methods. Media is "read" into public view via various
PHP scripts that check for user access. If a media item is called improperly or from without the script or access rights
have been found lacking, then either a "permission denied" message is displayed or a
courtesy image is displayed.
- At the moment, only the GD library is supported. Version 2 comes bundled with PHP versions > 4.3. Code is
slowly being introduced that will enable Inmemoriam to support the NetPBM and ImageMagick libraries as well.
- Inmemoriam is making use of the Image_Transform Pear Package, which basically provides a standard interface
to manipulate images using different libraries. Note: Take note of your install instructions and the need to drop these
related files into your Geeklog's Pear directory.
- Currently supported image functions include:
- Resize is used for creating thumbnails and for scaling images to fit into a specified box size.
- Fit is used to resize an image so that it will fit into a specified box size. This is used when displaying
a scaled image.
- The watermark function is currently supported fully alongside GDlib. Issues remain for the image watermark function
when using the ImageMagick and NetPBM libraries. I suggest that if you want to apply image watermarks, use GDlib.
- Warning: At the moment, using NetPBM or ImageMagick to
accomplish image watermarking WILL overwrite your original images. This issue is being investigated.
- The text watermark functions for all three image libraries. The font used for these "labels" is
specified in Inmemoriam's config.php file.
- For more information regarding how to apply a watermark, see the media editor section above.
- Functions planned for future releases include:
- Rotate will be implemented in order to correct uploaded, but not properly prepared images.
- Grey scale will be implemented for the sake of styling an image or an entire album. This function can serve a number of
purposes, e.g.: another way in which to protect full color images from theft when that image is for sale; or simply to
display a different look to a particular type of image (sculptures, portraits, etc.) or group of images.
- Watermarking is accomplished from the media editor. The process is applied, at the moment, for
scaled images and for full size images, but not for thumbnails. I will not be applying watermarks to thumbnails.
- Static images are accomplished from the administration panel. The main purpose of static images is to speed up
the loading time of any given Inmemoriam page. Keep in mind that the media is still read into the page via a script, so load
time is still extended even with the use of static images. See the admin section for more info.
- The moderation queue exists whenever media has been added to an album by anyone not the album owner or not
a gallery administrator. In the event that an album accepts submissions and the queue is turned on and a submission
has been made, then a "media queue" link will appear in the album owner's user functions block or that of
a gallery administrator. The link leads to the queue where submissions may be approved, deleted, or edited and saved.
- Aside from the moderation queue, all administration functions can be accessed via the Inmemoriam link in your Geeklog's
admin block. The general admin functions are available from the main admin screen and are, where applicable,
applied globally, i.e., they affect the gallery as a whole rather than just a particular album or media item.
- The general settings deal with different levels of gallery access.
You may also define the default file size that is allowed when users are uploading media. Note:
If you allow members to add media from this screen, album submissions must still be enabled for a
particular album in order for members to be able add media to that album.
- The display settings limit the number of album summaries, search results, etc.
The random image block can be enabled/from this page or from the Geeklog blocks admin page. The "what's new"
listing can be enabled/disabled from this page as well. The "what's new" listing can appear in two different
ways: as a list of individual media items; or as a list of albums with a count of new media items per album.
The default date refers to that format which Inmemoriam will use throughout the gallery when displaying album
creation and access date and times. Email notifications can also be enabled/disabled from this page.
- About email notifictations: if email notifications are enabled, as they are by default, then any time media is
posted to the site via the media editor, the site admin is sent an email listing the items uploaded. Disabling
email notifications will also disable notification of items submitted to the moderation queue. Emails sent to
contributors upon media approval, assuming the media went throught the moderation queue, cannot be disabled.
- Note: in order to accommodate the upgrade script, the option to disable the menu item makes no difference.
However, once you have successfully upgraded to or installed version 0.9.0, go to the function
plugin_getmenuitems_inmemoriam() in the functions.inc file and follow the instructions
therein in order to enable this frivolous feature.
- An interesting feature found here is the ability to control the display of Geeklog's
left and right columns. Typically Geeklog will display a left column and the right column's
display will be dependant upon a parameter passed to Geeklog's COM_siteFooter. Inmemoriam utilizes
wrappers for COM_siteHeader and COM_siteFooter allowing for more immediate control over the column display.
- Clicking on the "directories" link will bring you to the "scan
after FTP" functions. Having uploaded any number of images and albums to your albums directory, as
outlined in your install instructions, you must now register that media in the Inmemoriam database tables. This page
provides you with the ability to automatically add any new media found by the scan to the database, or to manually
select media from a list for import to the database.
- Note: While in your FTP session do not forget to properly
set permissions on your uploaded media in order for Inmemoriam to properly operate on it.
- The Database page offers various data integrity checks that provide you with
the opportunity to clean up rogue entries in the database and/or on the server. Rogue or unattended entries
are the result of any number of potential errors that could occur during normal operation. Most of the potential
errors have been accounted for and will be dealt with as they occur, if they do. These scans allow you to fix those
that perhaps have not been anticipated.
- Start with scan #1 and work your way to scan #4. In this way you ensure that errors will be dealt with
properly as the scans become more particular.
- Scan #1 checks for user ID's that do not exist in the Geeklog users table. If any are found, all media
assigned to those uid's is reassigned to the root user and restricted from public view. This restriction
gives the gallery admin an opportunity to investigate the media.
- Scan #2 checks for albums that exist in the database and have no corresponding media on the server. Any
albums found will be deleted along with any and all sub-albums and/or media items that are assigned to that album ID.
- Scan #3 checks for media ID's that are assigned to non-existent albums. Any media items found will be removed
from the database.
- Scan #4 now checks for media that exists only in the database and not on the server. Any entries found
will be deleted.
- All scans return a list of items needing repair before any action is taken providing you with the opportunity
to deal with these errors manually.
- Inmemoriam's philosophy for deleting media after any of these scans is simple: if it's not in the database,
it's gone. One implication of this philosophy is that if you've uploaded a bunch of media via FTP and
have now come to the database scans rather than the directories page, you will end up having to upload
all that media again.
- Inmemoriam also offers you the ability to create database backups. These backups are table dumps of the Inmemoriam
tables only and no Geeklog specific tables are included. In future releases this backup may include data from the comments table.
- Backups are named according to the following schema: YYYYMMDDHHMMSS_inmemoriam_db_backup.sql.gz where YYYYMMDDHHMMSS
correspond to the current year, month, day, hour, minute, and second. As a result of this nomenclature, you may create
multiple backups per day.
- All backups are stored in $_CONF['path']/plugins/inmemoriam/backups/.
- Backup files do not include table creation information. If you are restoring your database tables from a backup, you
will need to create the tables first. Typically this shouldn't be necessary as most restorations will occur after a
fresh install, which creates any needed tables for you.
- The main purpose of the static images page is to speed up the loading time of any given
Inmemoriam page. When the script processes an image, it creates 4 different size static images--3 different size
thumbnails and a scaled image. Note: This process does not apply to watermarked images. Watermarked images
continue to be created "on the fly."
- When thumbnails are being generated, the sizes of the thumbnails created correspond to those defined in
Inmemoriam's config.php file. Do not change these sizes as other elements will be affected.
- The size of any scaled image generated corresponds to its parent album's default display size. Note: When/if
this size is changed from the album editor, any scaled images larger than the new size will be deleted
automatically and you will have to run this script again.
- The default compression of any of these static images is hard-coded into the image functions.
Thumbnails are set at 75% quality and scaled images at 80%. To change these settings see the
tips and tricks section below. Original/full views are unaffected by this.
- The option to delete any static images is also available. This is handy if you are running out of server
space. Static images are also deleted whenever Inmemoriam is properly uninstalled.
- The installation procedure is outlined in the install document.
- Upgrade procedure: Upgrading is as easy as copying new files over your old files and clicking the upgrade button that
appears on the plugins' admin page for Inmemoriam. See the install doc for more details. Presently you will be upgrading to
version 1.0 for Geeklog 1.4.
- Migrations: I hope to provide at the very least a quick and dirty migration path from Gallery to Inmemoriam. This
will happen when it happens so don't bug me. If anyone would like to contribute their time to this effort and is familiar with
Gallery, shoot me an email or just give it a go.
- To do list:
- Image functions including: grey scale; left and right rotation.
- I'm still considering using picture frames, but will use nested divs rather than tables.
- Image watermarking still lacks proper functionality when using the Imagemagick and NetPBM libraries.
- Much of the current code is being rewritten to deliver an object oriented solution rather than the
current procedural one.
- If you would like to support this project there
are a couple of ways to do this: you could donate your time and get into the code checking for bugs and submitting
solutions, creating new functions, or just cleaning up some of my disasters, uploading translations of the language file
would be of great help as well; alternatively you could donate funds
to the project and its developer via the PayPal button at SummitPages.ca.
- How To's
- How to use autolinks: Using Inmemoriam autolinks in other site content that supports autolinks
is as easy as 1, 2, 3.
- An autolink that refers to an album will look like this, [album:12 this is a cool album] where
the number equals the album's ID. The text after the album ID will form the hyperlink text. If this text
does not exist, default text will be supplied. When parsed, this will result in a simple hyperlink styled
according to your current theme's style for anchor tags.
- An autolink that refers to a particular image may look 2 different ways yet both do the same job. The image
syntax will display a text link while the thumb syntax will display a thumbnail of the corresponding image and it
will be linked to the larger sized version of that image.
- [image:452 this is a cool image]
- [thumb:38 but this one is better]
- The numbers here represent the individual media ID's while the text following the numbers
will be used as the link text or will be placed in the "title" attribute of the resultant
image tag respectively.
- Note: $_CONF['max_image_width'] and $_CONF['max_image_height'] are respected when using the
thumb syntax.
- Note: autolinks referring to other site content, as long as that content supports autolinks, will be
parsed in a media item's caption and also in an album's description.
- Note: if media, referred to by an autolink, becomes inaccessible for some reason, the resulting thumbnail
will show the courtesy image.
- Using autolinks in the forum plugin, version 2.3.2 final: see
this thread at
geeklog.net.
- How to add a theme:
- Create your CSS. Use the rules defined in the currently available CSS files as examples or even
as a template. Create any theme specific image that may be necessary (nav buttons for example).
- Drop your themeName.css file into the $_CONF['path_html']/inmemoriam/ directory and any images properly
named (nav buttons should be named after the theme--see current themes for example) into the
$_CONF['path_html']/inmemoriam/themeName/ directory.
- Add your theme name to the $INM_CONF['themes'] array found in Inmemoriam's config.php file.
- Your new theme should now be available now from the album editor.
- How to make a featured album: From the album display settings in the album editor, check the box saying, "set as
featured." It's that easy. Featured albums appear on the index page and only one album may be featured at any one time.
There are 2 featured album views: an album summary view; and a "photo blog" view, or thumb review.
- How to change the default thumbnail size: Most often size is specified for thumbnails whether they appear
in the album's thumbnail page or the random image block, etc. Here and there size is not specified however, e.g., autolinks,
when parsed, will use the default thumbnail size. This size is specified on line 53 of image.php and will take
one of three values: 1; 2; or 3 for small, medium, or large. The corresponding dimensions are defined
in Inmemoriam's config.php.
- How to create an RSS feed: From your admin menu choose "content syndication" then simply click on
"create new feed." If you have more than one plug-in that supports feed writing, then you'll have to choose
Inmemoriam from the list. You are now presented with the "feed editor," from which you may choose the type
of feed to create. Feed types include: most recent media additions to all albums; most recent media additions to a
particular album (all albums are listed and you can create a feed for every album that exists if you like); and most
recent comments submitted to any media supporting comments.
- How to add support for various media formats: Supported media formats appear in Inmemoriam's config.php file.
Adding support for a currently unsupported media type involves adding the file extension and its appropriate mime type to
the $INM_CONF['image_ext'] array in the config.php file. Similar arrays exist for supported audio, video, and document
formats.
- How to customize the courtesy image: When an image is called improperly, or when
a user no longer has access to an image that they may have used in an autolink, or if another host is calling for your
images (hotswapping), then a courtesy image will be displayed rather than the called for image. Inmemoriam displays
its splash image as the default courtesy image with a bit of text overlaid. To use a different image and/or text
find the function inm_courtesyImage() in image-functions.inc and edit the path to the default image. Just
use whatever path points to the image you want to use. You can also edit the overlaid text from within this
function, or simply edit the image itself inserting text where and how you would like.
- How to customize the splash page: There are a number of things you could do here.
- To replace the image used on the splash page, find $_CONF['path_html']/inmemoriam/images/splash.jpg
and replace that image with your own image by the same name.
- Alternatively, you can find $_CONF['path_html']/inmemoriam/image.php, search for "splash.jpg",
and simply edit the path and name of the image to point to yours. The maximum dimensions and quality of the displayed
image are also set here.
- All text that appears on the splash page can be edited in the the plugin's language file.
- You can edit the layout/style of the splash page from the relevant template file,
$_CONF['path']/plugins/inmemoriam/templates/splash.thtml.
- How to replace the default watermark image: The default watermark image is stored in
$_CONF['path']/plugins/inmemoriam/watermarks/. Place your custom watermark in this directory and ensure that the name
of your custom watermark is reflected in your config file's setting for $INM_CONF['default_wm'].
- How to turn off the "powered by" statement that appears at the bottom of all the Inmemoriam pages:
Find the inm_poweredBy() function in the functions.inc file and edit it so that it will return empty. What you
need to edit is clearly marked within the function itself--you have only to uncomment one line.
- Tips and Tricks
- Changing the default theme for all albums at once: There are a number of ways to do this, but the easiest
as well as the quickest would be to move your preferred theme to the top of the $INM_CONF['themes'] array in
Inmemoriam's config.php file.
- Limited HTML is allowed in the caption field in the media editor: line breaks and anchor tags. Autolinks
are also supported here.
- By default, when a user is deleted from the Geeklog database, any media that was owned by that user is
reassigned automatically to the site's root user. That media is also made inaccessible to the public. If
you would rather have the media deleted by default, follow these instructions: ...
- Find the function plugin_user_delete_inmemoriam() in your functions.inc file.
- Comment out, or delete the update queries and uncomment the delete queries that have been
provided there. Comments exist in the function to help you edit the proper lines.
- Having done that, all media owned by a deleted user will be deleted along with that user.
- Changing the public directory name from the default, inmemoriam: If you have yet to install the Inmemoriam,
simply edit $INM_CONF['path_html'] and $INM_CONF['url_html'] in Inmemoriam's config.php file.
If you have already installed Inmemoriam, then you will have one additional step, i.e., to rename the directory
itself. Rename $_CONF['path_html']/inmemoriam/ to reflect what you have in your config file.
Note: This change only applies to the public directory.
- Changing the default quality of images processed by Inmemoriam: Thumbnails generated by Inmemoriam are, by
default, generated at 75% quality, while scaled images are generated at 85% quality. To change these settings,
find $INM_CONF['thumb_quality'] and $INM_CONF['scaled_quality'] in the config.php file and edit
them to your preference. Full size images are viewed at 100% quality and this value is hard-coded.