wlindley.com

autonav-wl — A WordPress plugin
Version 0.2
2007-12-18

(c) Copyright 2007
William Lindley
http://wlindley.com
480.947.6100

# # #

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.

# # #

This plugin solves two frustrations with Wordpress:

* Having to include actual links in pages or posts… links that
will break when you change URL’s or reorganize your page structure
* Having to manually resize thumbnails when your client asks,
“Can’t we make the pictures just a bit bigger?”

The plugin has two parts:

1. List of child pages, laid out in table or list format.
Child pages can declare ’subpage_thumb’ as a Custom Field
and that thumbnail will be displayed above the link. Otherwise,
a thumbnail of the page’s first attachment will be shown.
2. Thumbnails of attached images. You can specify a folder and
all the images in that folder will be used; otherwise, the
Wordpress attached images will be shown. Can specify sort
order or explicit ordering.

NOTES:

* Thumbnail size specified in the plugin’s Administration screen will
cause all thumbnails to automatically be resized as each page is
displayed.
* Thumbnails will automatically be adjusted for site’s actual location.
So if you move your site to a new url, links and images won’t break.
* Plugin first tries picture.thumbnail.jpg and if that is not the right
size, will use, for example, picture.thumbnail-150×200.jpg … and
create that file if it does not exist. (Requires write access to your
upload directories)

AUTONAV GALLERY

invoke the image gallery within your Wordpress page text with:

[[autonav]]

Creates a table of linked images by removing all the images included
in the current post, and replacing them with automatically generated
thumbnails.

[[autonav subpages]]

Creates a table of all child pages of the current page. A link with a
thumbnail image will be created for each child page. Pages may have
the custom field ’subpage_thumb’ set to the URL; if present, that will
be used for the thumbnail. Otherwise, the page’s first attached image
will be used.

[[autonav attached=file]]

Creates a table of all images attached to current page, with links to
images (same as “Link to File” under Browse in the page/post
Attachments window). Generally use this when combined with a lightbox
style plugin.

[[autonav attached=page]]

creates a table of all attached images, with links being to the
attachment’s Wordpress page (same as “Link to page” under Browse in
the page/post Attachments window).

[[autonav folder=project1]]

Creates a table of all images in uploads/project1

* * *

Thumbnails will automatically be created. Thumbnails default to
150×130 when 4 columns, 200×150 for 3 columns. Can override those
through admin screen.

Modifiers:

[[autonav subpages list_type=list]]

Creates an unordered list (<ul>) of subpages, instead of the default
table.

[[autonav subpages pics_only]]

Includes only child pages for which a thumbnail image can be found.

[[autonav columns=3]]

Creates 3 columns.

[[autonav indiv]]

Creates an individual (separate) table for each row.

[[autonav indiv=2]]

When indiv=2, all rows except the last row will be in one table; and
the last row will be in its own table. For centered tables, this may
be a more pleasing visual effect.

[[autonav thumbwidth=170 thumbheight=125]]

Requests 170×125 thumbnails. If each ‘picture.thumbnail.jpg’ is not
170×250, a file named ‘picture.thumbnail-170×125.jpg’ will be created.

[[autonav folder=mypics order=17,03,01]]

Will display only three images — the first alphabetically whose
filenames end in 17, 03, and 01. Note to use ‘01′ instead of just ‘1′
which might select an image ‘11′ first.

[[autonav sort=reverse]]

Reverses alphabetical sort. Note, forward/reverse sort occurs before
the ordering above.

STYLESHEET NOTES

Classes used:

autonav-table image thumbnail tables
autonav-row rows (<tr>) in above table
autonav-cell cells (<td>) in above table

subpages-table subpage tables (images & text)
subpages-row
subpages-cell
subpages-name Paragraph containing child page’s title in table

subpages-list Class for <ul> containing subpage list
subpages-item List item (<li>) class