About Textformatter Page Images

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.

Category 1Markup Generation
Markup modules that are called upon to generate or parse markup (like HTML). Markup modules are most often used on the front-end of a site (rather than admin).
Category 2Text Formatters
Textformatter modules that provide run-time formatting for blocks of text (typically used with Text/Textarea fields).
Release StateStable
Should be safe for use in production environments. *
Authorskixe, diogo
Module Version1.0.7
Class NameTextformatterPageImages
Compatibility2.5, 2.6, 2.7, 3.0
Date AddedOctober 25, 2015
Last UpdatedOctober 17, 2019
Recommended ByNew recommendations may take up to 1 day to appear.

Instructions

This module's files should be placed in /site/modules/TextformatterPageImages/
How to install or uninstall modules

README

Textformatter Page Images

Syntax

  • includes an image-tag in the Textfield by using [[fieldname(optional),number(optional),class(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

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.