Developer plugin for rapid prototyping of custom section types in Typesetter CMS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_types
docs/controls
image
universal_editor
.editorconfig
.gitattributes
.gitignore
Addon.ini
CustomSections.php
CustomSections_Admin.php
LICENSE
README.md
screenshot-01.png
screenshot-02.png

README.md

Custom Sections plugin for Typesetter CMS

About

Developer plugin for easy prototyping and creation of custom section types. Simple section types can be built even without PHP and JS skills, using the 'universal editor' and {{value}} placeholders. Current version 1.0b2

See also Typesetter Home, Typesetter on GitHub

Requirements

  • Typesetter CMS 5.0+

Manual Installation

Until the plugin is released on typesettercms.com, you need to download and install it manually:

  1. Download the master ZIP Archive

  2. Upload the extracted folder 'CustomSections-master' to your server into the /addons directory

  3. Install using Typesetter's Admin Toolbox -> Plugins -> Manage -> Available -> Custom Sections

Screenshot

Demo section type "Shop Item" using the universal editor component.

Screenshot

Currently available control types

These control types are ready to be used in 'universal editor'

control_type control_type control_type
checkbox

Screenshot
ck_editor

Screenshot
pops up a CK Editor in a modal box
image

Screenshot
opens a file manager
text

Screenshot
select

Screenshot
link_field

Screenshot
with autocomplete for
internal pages and button that
opens a file manager
clockpicker

Screenshot
colorpicker

Screenshot
datepicker

Screenshot
multi_image

Screenshot
opens a file manager window
radio_group

Screenshot
iconpicker(extra control)

Screenshot
knob(extra control)

Screenshot
multi_date(extra control)

Screenshot
with sorting option,
dates are managed in modal boxes

A note for users/admins

Custom Sections is a developer/designer plugin. To make use of it, you will need to have at least basic coding skills, namely HTML and CSS, and have some experience in Typesetter’s section management. You won't necessarily have to know much about PHP or JavaScript but you must not produce syntax errors (such as missing quotes, brackets, etc.) when building upon the demo types. Required coding skills grow with the complexity of things you're planning to do. The bundled section types, whichever they might eventually be, are merely meant as examples and they certainly won't be of any practical use unless you figure out how to adapt them. We will subsequently try to make the plugin as fail-safe as possible and to provide decent documentation. For the time being (beta stage) some parts will be hard to understand and are subject to change. So, to come to the point, if you're not into coding at all, this one is not for you.

A note for developers

Building own section types normally requires in-depht knowledge of Typesetter CMS. This plugin will make things way easier, but it still hooks into the CMS at a rather low level. This implicates that Typesetter will not be able to catch and report all errors like it can do on higher levels. Especially errors in the editor components, which are 'AJAXed' in a combined form togehter with other script components required for editing, can be quite tricky to debug. When you start creating your own section types using this plugin, frequent testing is a good idea.

Credits

a2exfr, juergen

License

GPL License, same as Typesetter CMS. For bundled thirdparty components see the respective subdirectories.