Download the PHP package toutouwai/inputfield-select-images without Composer
On this page you can find all versions of the php package toutouwai/inputfield-select-images. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download toutouwai/inputfield-select-images
More information about toutouwai/inputfield-select-images
Files in toutouwai/inputfield-select-images
Package inputfield-select-images
Short Description A ProcessWire inputfield that allows the visual selection and sorting of images, intended for use with FieldtypeDynamicOptions.
License MPL-2.0
Homepage https://github.com/Toutouwai/InputfieldSelectImages
Informations about the package inputfield-select-images
Select Images
A module for ProcessWire CMS/CMF. An inputfield that allows the visual selection and sorting of images, intended for use with the FieldtypeDynamicOptions module. Together these modules can be used to create a kind of "image reference" field.
Integration with FieldtypeDynamicOptions
InputfieldSelectImages was developed to be used together with FieldtypeDynamicOptions (v0.1.3 or newer):
- Create a Dynamic Options field.
- Choose "Select Images" as the "Inputfield type". Select Images appears in the "Multiple item selection" category but you can set "Maximum number of items" to 1 if you want to use Select Images for single image selections.
- Define selectable options for the field via a
FieldtypeDynamicOptions::getSelectableOptions
hook. See some examples below.
FieldtypeDynamicOptions is recommended but is not a strict requirement for installing InputfieldSelectImages in case you want to use an alternative way to store the field data.
Selection of Pageimages
In this example the field allows selection of Pageimages that are in the "images" field of the home page.
The field will store URLs to the Pageimages so it works as a kind of "image reference" field. You can use the "Format as Pagefile/Pageimage object(s)" option for the Dynamic Options field to have the formatted value of the field be automatically converted from the stored Pageimage URLs to Pageimage objects.
Selection of image files not associated with a Page
When not working with Pageimages you must add a "data-thumb" attribute for each selectable option which contains a URL to a thumbnail/image.
In this example the field allows selection of image files in a "/pics/" folder which is in the site root.
The field values don't have to be image URLs
The values stored by the Dynamic Options field don't have to be image URLs. For example, you could use the images to represent different layout options for a page, or to represent widgets that will be inserted on the page.
Also, you can use external URLs for the thumbnails. In the example below the options "calm" and "crazy" are represented by thumbnails from placecage.com.
Field configuration
If the inputfield values are Pageimage URLs then you can optionally include a button for each selected image to open the containing page for editing in a modal window. Note that if the selected image is contained in a Repeater item then it is the Repeater page that will be opened for editing.
You can define labels for the button, notices, etc, that are used within the inputfield if the defaults don't suit.
All versions of inputfield-select-images with dependencies
processwire/processwire Version >=3.0.0
wireframe-framework/processwire-composer-installer Version ^1.0.0