Content last modified Monday 6 March 2017
hop to #bottom
Categories:
Author:
Current version:
0.6.2
About It:
Get it:
Rate it:
  • Helpful?
  • 1 Yes
  • 0 No
Flag it:

If you'd like to provide updated information and do not have access to directly edit, please contact the site admin; thanks!

hak_article_image

<txp:hak_article_image /> is an enhancement to <txp:article_image /> it supports multiple images per article along with various ways of attaching links to the images. The article image field should contain one or more numeric image IDs separated by commas.

<txp:hak_article_thumb /> displays the image thumbnail(s) with an options to link the thumbnail in various different ways.

Attributes:

  • limit=‘x’ : Show only x number of images. Default is all images in the article image field.
  • offset=‘x’ : offset the first image shown by x images.
  • link=‘1’ : links the image in manner determined by linktype.
  • linktype=‘type’ : type of link to create. Options:
    • image : link to the full size image.
    • page : link to the current page passing the image id in a way that can be used by <txp:image_display /> or <txp:hak_article_image urloverride="1" />.
    • section : link to a specific section defined in the section attribute passing the image id in a way that can be used by <txp:image_display /> or <txp:hak_article_image urloverride="1" />.
    • category : link to the image’s category page or to a specific category defined in the category attribute passing the image id in a way that can be used by <txp:image_display /> or <txp:hak_article_image urloverride="1" />.
    • section-category : link to a specific section defined in the section attribute and to the image’s category page or a specific category defined in the category attribute passing the image id in a way that can be used by <txp:image_display /> or <txp:hak_article_image urloverride="1" />.
  • section=‘section name’ : section to link to when using linktype=‘section’ or linktype=‘section-category’ .
  • category=‘category name’ : category to link to when using linktype=‘category’ or linktype=‘section-category’ .
  • anchor=‘anchor name’ : pass an anchor along with the link. Not available when using linktype=‘image’ because there would be no point.
  • popup=1 : makes the link open in a popup window. Only available when using link.
  • popwidth=‘integer’ : increase the popup window width by this much.
  • popheight=‘integer’ : increase the popup window height by this much.
  • urloverride=‘1’ : will override the image displayed with the image passed in the url by <txp:image_index /> or <txp:hak_article_image displaylink="1" />. Would normally be used along with limit=‘1’
  • urlhide=‘1’ : will not display the image if it matches the image being passed in with the url, by using linktype=‘section or page’ or <txp:image_index />
  • rel=‘attribute’ : passes a rel attribute to a link created by link=‘1’ useful for lightbox/thickbox fun.
  • class=‘classname’ : passes a class attribute to a link created by link=‘1’ .
  • linktitle=‘attribute’ : passes a title attribute to a link created by link=‘1’ also useful for lightbox/thickbox fun. Can accept any text or two special keywords:
    • txp:caption : inserts the image’s caption.
    • txp:alt : inserts the image’s alt information.
  • form=‘form name’ : allows you to use a form to control the image output. See below.
  • Both tags support the standard break, wraptag, class and breakclass attributes.

Using forms

<txp:hak_article_image /> also supports using forms to format how your article images are displayed. Forms also give you access to the image’s caption information. All the same attributes are available but they are distributed among different tags.

<txp:hak_article_image /> and <txp:hak_article_thumb /> control which images will be used. It takes the following attributes:

  • limit
  • offset
  • urloverride
  • urlhide
  • The standard break , wraptag , class and breakclass attributes.

Form Tags

<txp:hak_article_image_link /> creates a link with various options. Should be used as a container tag with an opening and closing tag. It takes the following attribues:

  • type same as linktype
  • section
  • category
  • anchor
  • popup
  • popwidth and popheight
  • rel
  • title same as linktitle
  • class same as linkclass

<txp:hak_image /> and <txp:hak_thumbnail /> displays either the full size image or the thumbnail. Accept a class attribute.

<txp:hak_image_caption /> displays the caption for the current image. Accepts the standard break, wraptag, class and breakclass attributes.

<txp:hak_image_alt /> displays the alt information for the current image. Accepts the standard break, wraptag, class and breakclass attributes.

Article Request Count:
Keywords/tags:
Initially released:
August 23, 2005
Posted here:
23 Aug 2005
Article modified:
23 Apr 2007

If there is a comment form at the Information URL, you may want to leave your comments/questions there or at the Forum thread for quicker feedback. Otherwise, comment away:

Your comment will NOT be submitted until you click the 'Submit' button on the next pageload.

Commented (4)

10x to you. Very cool plugin

Super! This is exactly what I was hoping existed. Serious kudos for making it flexible enough for Lightbox/Thickbox. If I could give you a hi-5 in person, I would.

Husain Hakim:

Say, I have a huge gallery of photos in various sections/categories, can I display the article images in the search results, along with the article title using the default TXP search?

dee:

Unbelievably useful – thank you very much.

Subscribe to this article's comments RSS feed. [ ? ]   View Recent Comments across the site.

You know you want to visit the Archives.

Browse

Categories


Articles

There are also tag clouds, 'cause those are fun.
Published with Textpattern