Textpattern Resources at textpattern.org

<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.