Download the PHP package wbrowar/craft-communicator without Composer
On this page you can find all versions of the php package wbrowar/craft-communicator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wbrowar/craft-communicator
More information about wbrowar/craft-communicator
Files in wbrowar/craft-communicator
Package craft-communicator
Short Description Tools that communicate project-specific information between clients, admins, and developers.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package craft-communicator
Communicator plugin for Craft CMS 3.x
Tools that communicate project-specific information between clients, admins, and developers.
For users of Guide 1.3.x and below: This plugin is a replacement for the three widgets that are included in Guide. These three widgets and all of their data will be removed from Guide in a future update: Website Updates, Welcome Widget, and Email Support.
Requirements
This plugin requires Craft CMS 3.1.1 or later.
Installation
Communicator can be installed through the Craft CMS Plugin Store, or by following these instructions:
-
Open your terminal and go to your Craft project:
cd /path/to/project -
Then tell Composer to load the plugin:
composer require wbrowar/craft-communicator - In the Control Panel, go to Settings → Plugins and click the “Install” button for Communicator.
Communicator Overview
Communicator has three major features:
Changelog
A record of changes that have been made to the website or CMS that appears on a widget and in its own CP section.
Changelog includes:
- A CP section that shows all changelog entries.
- A widget that can be configured to show a desired amount of changelog entries.
Global Widget
Widget content that is created once and distributed to all users who have the widget on their dashboard.
Global Widget includes:
- A widget that renders the content pulled from a single source.
- A CP section that allows permitted users to create and update content in either Markdown or Twig formats.
Email Support
A widget that provides an email support form that can include details about the browser your client is using.
Configuring Communicator
Changelog Configuration
- To view the Changelog CP section, the
Access Communicatoris required. - The
Edit Changelogspermission is required to add and remove changelog entries.
Global Widget Configuration
- To view the Global Widget CP section and edit Global Widget content, both the
Access CommunicatorandEdit Global Widgetpermissions are required.
Email Support Configuration
- Before a user may submit a support email, at least one support contact must be added.
- Support contacts can be added on the Communicator plugin settings page.
- The email form may be disabled in Communicator plugin settings, and doing so will display the support contact‘s email and—if provided—phone number.
All features are enabled by default, however, if you don‘t need a specific feature, the Communicator plugin settings page will allow you to completely disable a feature. Disabling a feature will not remove its widgets from user dashboards. A message will state that the feature is disabled and that the widget can be removed.
Using Communicator
Using Changelog
- A user may add the Changelog widget to their dashboard and can configure the amount of changelog entries shown.
- They can also get to the Changelog CP section by clicking on the
Changelogsidebar link or the button that appears at the bottom of the widget. - Users with the ability to
Edit Changelogswill see a form on the Changelog CP page that lets them add a new changelog entry.- Changelog entries use Markdown for rendering.
- A template is provided to make editing easier, but it can also be ignored if this is not the desired format.
- Using the specific headers,
Added, Changed, Fixed, Deleted, as any level of header element,H1, H2, H3, H4, H5, H6, will result in specific styling and an appropriate emoji symbol. - For example,
# Addedwill be converted to🚀Added - Changelog entries can be removed by clicking on the
Deletebutton next to each entry.
Using Global Widget
- A user may add the widget that displays the Global Widget header and content and there is nothing to configure.
- If the Global Widget content is in Twig format, the information will be shown in context for the logged in user.
- Users with the
Edit Global Widgetpermission, may visit the Global Widget CP section to edit the Global Widget content.
Using Email Support
- Users who add the Email Support widget to their dashboard will be required to select a support contact before submitting a support email.
Communicator Roadmap
Some things to do, and ideas for potential features:
- Provide a way to use a template path for Global Widget content so boilerplate content may be used from one project to another.
- Disable the ability for a user to select their contact person in the Email Support widget by providing default contact information for specific users.
- Add priorities to support emails and reflect that in the subject of the email.
Brought to you by Will Browar
