Download the PHP package janvince/smallmessages-plugin without Composer
On this page you can find all versions of the php package janvince/smallmessages-plugin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package smallmessages-plugin
Small Messages
Simple plugin to manage frontend and backend messages
Installation
GitHub clone into /plugins
dir:
OctoberCMS backend
Just look for 'Small Messages' in search field in:
Settings > Updates & Plugins > Install plugins
Permissions
Settings > Administrators
You can set permissions to restrict access to Settings > Small plugins > Small Messages and to messages list.
Quick start guide
-
Install plugin.
-
Go October's backend Settings and choose Small Messages.
- Select your prefered UI style and optionally add Close button's text.
-
Go October's backend and choose Messages from main menu.
- Create new Message and set it as Active (you can also set dates from/to and choose to control messages window by cookie).
- Go to CMS part of October.
- Add new o use existing Layout, Page or Partial.
- Add component Small Messages > messages (inside of your
body
tag).
Do not forget to add
{% scripts %}
tag to your layout page just before closingbody
tag! More info in October docs.
- Open your website - message should be visible.
Components
Messages
Should be used in your Layout, Page or Partial.
Visibility
You can set date from and/or date to if you want to control when a message box should appear on your web site.
Restrictions
You can add list or (relative) URLs where message box should appear.
Cookies
You can add a cookie control (with custom expiration) so when a user click Hide button, message box will not appear again (until a cookie expires).
You can add URLs where message box will appear even with cookie (eg. useful for /contact page).
Manually disable messages box
If you need to hide Messages box on specific Partial, Page or Layout, you can use View Bag on your Page this way:
HOWTO
Get list of messages
With component attached you can get messages list by {{ messages.items }}
.
Your custom messages box design
If you want your custom messages box design just create folder and file messages
in /themes/[your-theme-name]/partials/messages/default.htm
and put your code.
If you changed default alias of Messages component (which is
messages
) you have to change also folder name!
For default code you can look in /plugins/janvince/smallmessages/components/messages
.
My thanks goes to:
OctoberCMS team members and supporters for this great system.
Possessed Photography for banner photo.
Font Awesome for nice icons.
Created by Jan Vince, freelance web designer from Czech Republic.