TextformatterPageImages by kixe

Allows you to insert images in a text area by referencing them with tags in the following format [[fieldName,Number,class]]. All Parameters are optional. Configurable base class and wrapper.

Textformatter Page Images

Syntax


  • includes an image-tag in the Textfield by using [[fieldname(optional),number(optional),class(optional),page-ID(optional)]]
  • if using this module Names of Imagefields shouldn't start with a number
  • If a class (CSS) is added Fieldname and/or Number and/or leading Comma is mandatory
  • Comma is mandatory from two Parameters and up

Look at the Examples for easy understanding

Examples


[[]] matches the first or only one picture in the first or only one image-field if exists
[[images]] matches the first or only one picture in the named image-field
[[4]] matches the fourth picture in the first or only one image-field
[[3,left]] matches the third picture in the first or only one image-field and adds the class left
[[,right]] matches the first or only one picture in the first or only one image-field and adds the class left
[[images,3,top]] matches the third picture in the image-field named 'images' and adds the class top
[[,,,1234]] matches the first or only one picture in the first or only one image-field of the page with ID = 1234
[[images,3,top,1234]] matches the third picture in the image-field named 'images' of the page with ID = 1234 and adds the class top

Settings


  • One or more basic classes could be added to the image tag
  • Define custom markup for wrapper. Any PageImage property surrounded by curled brackets will be replaced by the related value. Additional properties (class, index, urlSmall, urlMedium, urlLarge) available. Default markup:
<img class="{class}" src="{url}" alt="{description}"/>

Hooks


function wrapper() is hookable with instance of Pageimage as argument.

Compatibility


Works well with other text formatters such as Markdown.

Thanks


to Diogo for the nice module TextformatterImageTags which is the mother of this module.

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Twitter updates

  • ProcessWire 3.0.185 (dev) core updates, plus new Session Allow module— More
    17 September 2021
  • Three new ProcessWire Textformatter modules: Find/Replace, Markdown in Markup, and Emoji— More
    3 September 2021
  • This week we have a new master version released after a year in the making. With nearly 40 pull requests, hundreds of new additions and more than 100 issue reports resolved, this new version has a ton of great new stuff— More
    27 August 2021

Latest news

  • ProcessWire Weekly #388
    In the 388th issue of ProcessWire Weekly we'll check out the latest core update, introduce two new third party modules, and more. Read on!
    Weekly.pw / 16 October 2021
  • ProcessWire 3.0.184 new master/main version
    This week we have a new master/main version released after a full year in the making. As you might imagine, this new version has a ton of great new stuff and we’ll try to cover much of it here.
    Blog / 27 August 2021
  • Subscribe to weekly ProcessWire news

“ProcessWire is like a breath of fresh air. So powerful yet simple to build with and customise, and web editors love it too.” —Margaret Chatwin, Web developer