This plugin extends Rainlab Blog and Rainlab Pages plugins.
Blog
- Replace default Markdown editor with system WYSIWIG richtext editor, change it's toolbar buttons.
- Allows to change post author (you can also add new content field to system administrator's form)
- Allows to link to Rainlab.Users user
- Allows to add/or replace original featured images upload field with one featured image selectable from Media manager or uploaded
- Add translatable repeater form field with simple builder so you can add any number and type of form fields to Blog post
- Add some simple custom fields to blog post form (string, text, switch, datetime, repeater)
- Add Preview post button to editor toolbar
Pages
- Duplicate static page
- Add new fields to static Menu items
- Notes (textarea)
- Image (mediafinder)
- Color (text)
- Optionally hide default Content tab
System tools
- Extend Group Repeater to support titleFrom
- PHP info overview
Twig extensions
- New functions
getImageSizeAttributes()
to automatically add width and height toimg
tag- Bypass
|_
and|__
filters if Rainlab Translate plugin is not installed. - Add truncate filter
Report Widgets
- Cache cleaner
- There is a dashboard widget that cleans cache files and folders.
- It doesn't use Artisan
cache:clear
so it works on sites whereputenv()
function is disabled.
- Optimize DB (only sqlite is supported yet).
Components
- Force login
- When placed in page, layout or partial and allowed in Plugin's settings, forces login to backend area.
- Useful while testing pages (or whole site) to limit access to logged in administrators only
The following plugin is required
This plugin is also included into the following bundle
Small Extensions
Set of small tools for Rainlab.Pages and Rainlab.Blog plugins .
Installation
GitHub clone into /plugins
dir:
git clone https://github.com/jan-vince/smallextensions
OctoberCMS backend
Just look for 'Small Extensions' in search field in:
Settings > Updates&Plugins > Install plugins
Permissions
You can set permissions to restrict settings page of this plugin.
Rainlab.Blog Extension
OctoberCMS > Backend > Settings > Small Extensions > Blog
Depends on: Rainlab.Blog plugin!
Rainlab Blog is a great plugin, but none of my clients is happy with MarkDown syntax to edit posts.
Settings
-
WYSIWYG editor
- Enable to switch between default MarkDown or OctoberCMS's Rich editor.
- Allows you to add custom toolbar buttons.
-
Change post author
- Adds post author field with administrators dropdown
-
Link Rainlab User
- Adds Rainlab User field with users dropdown (but will be visible only if Rainlab User plugin is installed)
-
Custom fields
- Adds selected extra fields to blog post editing page on More tab (available fields: API code, string, text, switch, date&time, repeater (as notes) and Media image)
- Allow to replace original featured images upload field with one featured image selectable from Media manager
Rainlab.Pages Extension
OctoberCMS > Backend > Settings > Small Extensions > Static pages
Depends on: Rainlab.Pages plugin!
Settings
-
Hide Content field (depricated)
- Allow to hide default Content tab and field from Pages editing page.
- Useful for those, who uses {variable} fields and are little bit confused with default secondary content tab.
-
Enable Menu notes
- If on, new tab Notes and a field Note is added to Menu items editing popup window.
- text is then accessible from page/layout from {{item.viewBag.note}}.
-
Enable Page duplicating
- If on, Static Pages can be duplicated by backend user.
System Extension
OctoberCMS > Backend > Settings > Small Extensions > System
Settings
- Custom fields
- Adds extra fields to backend administrators form (currently only field description)
Twig Extensions
New functions
-
getImageSizeAttributes(image)
- Get image dimensions for use in
<img>
tag like:<img src="{{image.getPath}}" {{getImageSizeAttributes(image)}}>
- Will output
<img ... width="123" height="123">
.
- Get image dimensions for use in
-
|_ (trans), |__ (choice)
- If Rainlab Translate plugin is not present, bypass trans and choice functions
-
truncate
- {{ text|truncate(20, true, '*') }}
- length, preserve words (default false), separator (default is '...')
Report Widgets
Cache cleaner
There is a dashboard widget that cleans cache files and folders.
It doesn't use Artisan :clear
so it works on sites where ()
function is disabled.
Optimize database
There is a dashboard widget that optimize database.
Supported databases and used commands:
- SQLite - VACUUM
Components
Force login
You can place forceLogin component to your page, layout or partial.
Than if you check force login
checkbox in Plugin's settings, visitors will be redirected to ```` configured in
/config/cms.php````.
Useful when you need to limit access to several pages or whole site to only administrators while testing.
My special thanks goes to: OctoberCMS team members and supporters for this great system. Joel kyber for his photo I have used in the plugin banner. Font Awesome for Universal access symbol.
Created by Jan Vince, freelance web designer from Czech Republic.
-
Kutup
Found the plugin useful on 20 Feb, 2021
Hi Jan,
It's a great plugin and it does all the work for me. Thank you so much.
At a small point I need your support. How do I add multi-language support to the menu notes? Ranilab translate support.
-
Kai
Found the plugin useful on 1 Oct, 2020
Works! But documentation is not updated and complete. Images for Static Pages do not need a fix anymore and twig code for that is: item.viewBag.image. Would be nice to be able to add custom fields to CMS, Static Pages and Blog like the plugin "CustomFields" so one of this plugin could be saved. :) With custom fields in the plugin f.e. a template selection can be made (for article, video or gallery posts etc.).
-
Jan Vince author
Replied on 1 Oct, 2020
Hi and thanks for comment - I will update docs as soon as I have some spare time :)
Best regards,
Jan
-
Marco Inward
Found the plugin not useful on 29 Apr, 2020
I don't understand what's wrong with this plugin. When I edit blogs with RichEditor, regardless of whether I align an image to the left or the right, it ALWAYS aligns to the right. It doesn't change the assigned classes. If I try change the classes manually, it just changes them back. Please assist.
-
Jan Vince author
Replied on 29 Apr, 2020
Hi Marco,
my plugin only replaces original Markup editor with built in Richeditor. So problem with picture alignment my plugin cannot solve (or even cause).
Generaly when you insert picture inside an editor you can click on it and in popup menu you can control it’s alignment with second icon. Also you can change picture’s behavior by clicking on a Star icon.
If you need more assistance, you can ask on OctoberCMS forum, on GitHub or on Slack.
Anyway thanks for trying my plugin.
Best regards,
Jan
-
Fractal Solutions
Found the plugin useful on 14 Mar, 2018
"Allows to replace original featured images upload field with one featured image selectable from Media manager"
This feature alone is worth having in any plugin list. Thank you very much for creating this plugin. A true "must have"!
-
Jan Vince author
Replied on 15 Mar, 2018
You are welcome :)
-
Eric Leohner
Found the plugin useful on 11 Nov, 2017
The thing I love about October is the quality of work that developers bring to it. And Jan absolutely hits the mark with this. While I prefer the markdown editor for the blog, having the option to make it WYSIWYG for clients is invaluable. The PHP overview is a nice touch. It's a plugin that bleeds quality and care.
Because of it, I'm going to install his other plugins, confidently knowing that he's made them both powerful and user-friendly.
-
Jan Vince author
Replied on 11 Nov, 2017
This is only a small plugin but thank you very much for your review :)
Jan
-
Wojciech Krakowiak
Found the plugin useful on 26 Nov, 2016
Great, simple and working plugin, thank you! :) It just wonder if I could manipulate editor's options (remove some styles, add another ones, etc.)
-
Jan Vince author
Replied on 26 Nov, 2016
Depends on what you need.
If you need new paragraph formats, you are probably looking for this.
If you just only need CSS classes for editor's content, look in OctoberCMS backend in Settings > Editor settings > Markup classes.
And I will publish today an update to allow custom editor toolbar buttons.
Hope this helps :)
Have a nice day...
-
1.21.0 |
Static pages duplicating tool Oct 18, 2023 |
---|---|
1.20.0 |
Added meta_title and meta_description fields to Blog Categories Oct 06, 2023 |
1.19.2 |
WYSIWYG option for Blog is now deprecated Mar 05, 2023 |
1.19.1 |
Fixed truncate Twig filter to support UTF8 Jan 19, 2023 |
1.19.0 |
Updated OC3 compatibility Nov 09, 2022 |
1.18.1 |
Added Twig truncate filter Jul 19, 2022 |
1.17.1 |
Check if phpinfo is enabled Jun 10, 2022 |
1.17.0 |
Options to add image width and height in Static Pages menu items Mar 24, 2022 |
1.16.8 |
Fixed MLRepeater JS block Jan 10, 2022 |
1.16.7 |
Fixed Repeater block titles Nov 09, 2021 |
1.16.6 |
Fixed Repeater and MLRepeater support Sep 30, 2021 |
1.16.5 |
Fixed partial path Sep 24, 2021 |
1.16.4 |
Truncate long group repeater titles Sep 24, 2021 |
1.16.3 |
Better (but still limited) MLRepeater support for group repeater block title Sep 24, 2021 |
1.16.2 |
Added (limited) support for MLRepeater to have both group name and first available text input value as collapsed block title Sep 24, 2021 |
1.16.1 |
Better handling of Group repeater title when titleFrom is allowed Sep 23, 2021 |
1.16.0 |
Added option to allow Group Repeater titleFrom option (extend Group Repeater item title) Sep 23, 2021 |
1.15.0 |
Option to add Preview post button to Blog editor toolbar Sep 07, 2021 |
1.14.0 |
Option to hide Blog excerpt field Aug 24, 2021 |
1.13.0 |
Added new columns for Blog categories Aug 17, 2021 |
1.12.5 |
Do not show section field type in Blog columns Mar 26, 2021 |
1.12.4 |
Option to add (new) custom repeater as a simple form (when you do not need repeating) Mar 26, 2021 |
1.12.3 |
Added list columns for (new) custom repeater fields Mar 26, 2021 |
1.12.2 |
Auto create Rainlab Blog column for custom_repeater if Blog plugin was installed after Small Extensions Mar 23, 2021 |
1.12.1 |
Fixed schema update file Mar 23, 2021 |
1.12.0 |
Added new translatable custom repeater (with fields builder) for Railab.Blog posts Mar 22, 2021 |
1.11.0 |
Rearranged settings fields Mar 21, 2021 |
1.10.3 |
Added file field to Blog custom fields repeater Sep 14, 2020 |
1.9.3 |
Allow Twig extensions if not explicitly disabled Sep 02, 2020 |
1.9.2 |
Fixed artisan Blog post creation (thanks mbroadhead) Sep 16, 2019 |
1.9.1 |
Fixed raw SQL in Optimize DB report widget Jun 09, 2019 |
1.9.0 |
Added Optimize DB report widget Jun 08, 2019 |
1.8.3 |
Better detection of missing Translate plugin Jan 28, 2019 |
1.8.2 |
Fixed API Code field (thx SalocinDotTEN) Sep 06, 2018 |
1.8.1 |
Fixed unintended deletion of user when blog post is deleted (thx laurensmartina for issue) Aug 27, 2018 |
1.8.0 |
Added option to link Rainlab Blog post and Rainlab User Mar 15, 2018 |
1.7.4 |
Fixed widget translation Feb 14, 2018 |
1.7.3 |
Fixed translation Feb 08, 2018 |
1.7.2 |
Fixed Blog Post plugin check Feb 08, 2018 |
1.7.1 |
Added fully configurable repeater fields and labels Feb 08, 2018 |
1.7.0 |
Added new custom Rainlab Blog columns 'text' and 'repeater' Feb 08, 2018 |
1.6.0 |
Added option to allow extra fields in backend administrator\'s form (now only description is available) Feb 07, 2018 |
1.5.2 |
Fixed forceLogin redirection logic Feb 01, 2018 |
1.5.1 |
Added translations for forceLogin component Feb 01, 2018 |
1.5.0 |
Added forceLogin component that can be used to force login to backend area before visiting a page Feb 01, 2018 |
1.4.3 |
Fixed report widget Jan 30, 2018 |
1.4.2 |
Added option for report widget to clear thumbnails Jan 30, 2018 |
1.4.1 |
Fixed typo in cs locale Jan 18, 2018 |
1.4.0 |
Added Report widget to clean cache files and folders (for those affected with putenv() disabled problem) Jan 18, 2018 |
1.3.9 |
Fixed typo in translations Nov 17, 2017 |
1.3.8 |
Twig function to be enabled by default in settings Nov 17, 2017 |
1.3.7 |
Added trans and choice functions to bypass |_ and |__ twig filters if Rainlab Translate plugin is not installed. Nov 17, 2017 |
1.3.6 |
Added new Twig functions section Sep 13, 2017 |
1.3.5 |
Added server info tab with PHP info data Sep 06, 2017 |
1.3.4 |
Changed field type colorpicker to text only. Small change in Settings UI. Fixed some typos. Sep 06, 2017 |
1.3.3 |
Labels can be added to blog custom fields just right in the Settings Jul 20, 2017 |
1.3.2 |
Fixed settings translation for EN Jul 19, 2017 |
1.3.1 |
Added options for menu item image (imagefinder) and color (colorpicker) Jul 19, 2017 |
1.3.0 |
Added extra blog image columns for title and description Jul 14, 2017 |
1.2.5 |
Changed column type for repeater to 'text' instead of json (thanks CanThis) Jun 30, 2017 |
1.2.4 |
Fixed typo in fields.yaml (thanks Jorge Noguera) Jun 28, 2017 |
1.2.3 |
Check for singed in user in plugin's boot method Jun 12, 2017 |
1.2.2 |
Check permission for authors list and set default value for logged in user Jun 10, 2017 |
1.2.1 |
Disabled is_activated check for backend user as this is not needed Jun 10, 2017 |
1.2.0 |
Added post author field with administrators dropdown Jun 09, 2017 |
1.1.5 |
Editor toolbar buttons input field changed to textarea to support larger input (thanks kealsera) Jun 07, 2017 |
1.1.4 |
Removed Rainlab Blog code dependency Jun 03, 2017 |
1.1.3 |
!!! As of version 1.2.7 of Rainlab.Pages, custom fields are moved to secondary tabs area by default. If "Hide Content tab" setting of this plugin is set, custom fields will be moved back to primary tabs and secondary tabs container will be hidden. May 15, 2017 |
1.1.2 |
Small change in plugin category name May 15, 2017 |
1.1.1 |
All custom fields allowed while creating new blog post (previously allowed only on existing records) Apr 16, 2017 |
1.1.0 |
Added option to replace Blog featured images with one featured image selectable from Media manager Apr 16, 2017 |
1.0.11 |
Changed update class name to prevent installation exception Apr 14, 2017 |
1.0.10 |
Added extra blog image column Apr 14, 2017 |
1.0.9 |
Added option to hide content tab on Rainlab.Pages page Apr 05, 2017 |
1.0.8 |
Changed menu order number Apr 05, 2017 |
1.0.7 |
Added Custom fields for Blog posts (API code, string, switch and datetime) Jan 19, 2017 |
1.0.6 |
Fixed typo in permissions code (thanks Christopher19815) Jan 12, 2017 |
1.0.5 |
Field to set editor custom toolbar buttons Nov 26, 2016 |
1.0.4 |
Detect Rainlab.Translate plugin and support translatable WYSIWYG editor Oct 24, 2016 |
1.0.3 |
Added extra Notes tab to Static Menu items in Rainlab.Pages Oct 14, 2016 |
1.0.2 |
Added Rainlab.Blog WYSIWYG editor extension. Oct 12, 2016 |
1.0.1 |
First version of Small Extensions Oct 12, 2016 |