From Cerb Wiki
Jump to: navigation, search

Cerb (7.0) is a next-generation major update released on May 26, 2015. It contains over 110 new features and usability tweaks from community feedback. There are 70 additional improvements provided in 5 maintenance updates.

This is a summary of the most significant improvements. The full release notes may be viewed in the knowledgebase.

  • To check if you qualify for this release as a free update, view Setup->Configure->License. If your software updates expire on or after May 26, 2015 then you can upgrade without renewing your license.
Cerb 510 license expires.png



We design major functionality updates with backwards compatibility in mind -- both technically and conceptually. This means that when you update between two versions in the same "generation" (e.g. 6.8 to 6.9), you can expect your environment to still meet the same system requirements, and your workers should still feel completely familiar with how the interface and common functionality works.

Every two years or so, we plan and release a "generational" update. Those are the milestone where we allow ourselves to break backwards compatibility. We remove features and concepts that have been deprecated by new improvements along the way, and we introduce new features and concepts based on thousands of ongoing discussions with the community and several more years of accumulated experience. Generational updates may be a bit more disruptive than typical updates, but they are where Cerb takes big leaps forward.

Each generation of Cerb has had a central theme:

In 4.x, the theme was a clean slate. We completely rewrote Cerb from scratch to use modern design principles, to be highly stable and secure, to enable a much faster pace of development, and to be extensible through plugins with our Devblocks framework.

In 5.x, the theme was automation. We introduced Virtual Attendants for automating common workflows in a very flexible way. That evolved into one of the main reasons people use Cerb at all, and it expanded the kind of problems Cerb is suited to solve.

In 6.x, the theme was productivity. We introduced fully customizable, shared workspaces and dashboards for delivering the perfect interface to each worker based on their needs. We refined how common actions were performed in the interface, and incrementally reorganized to reduce clicks and keystrokes.

For 7.x, the theme is personalization and machine learning. As Cerb has matured, we've seen a sharp increase in the seat count of enterprise deployments. While shared workspaces are great for keeping large teams on the same page, the common issue that nearly all of those busy environments run into is that workers end up looking at the same exact lists and tripping over each other while trying to find work. With judicious filtering and dispatching, those issues can be minimized -- but the next issue becomes ensuring that workers are handling work in the appropriate order. Oftentimes, especially if a backlog forms, only the most recent records receive attention because workers approach their worklists like a traditional email client, which displays new messages at the top of the list. The older records become even later.

After a lot of research and experimentation, we've come up with what we feel is a powerful, flexible, and simple solution to this common problem:

  • Group members now have a variable level of responsibility for each bucket within the group. One worker may have a higher responsibility for clearing the group's inbox, while another focuses on a specialized bucket. Less actionable buckets like 'Spam' and 'Newsletters' can be pushed to the bottom of the list so they don't waste people's time.
  • Records within buckets have a variable level of importance (based on service level commitments, escalations, age, etc). A Virtual Attendant can simply boost the importance of new tickets from organizations with a service level agreement, and/or increase importance over time as unresolved tickets age. As you would expect from Cerb, you're not limited to these choices, and you can build whatever workflow works best for you.
  • Workers can sort worklists by their responsibility to see a highly personalized list: the records in their highest responsibility buckets, that are also the most important, and the oldest (all as a single sorted column). As a consequence, two workers may see the same set of records on a shared list, but in an entirely different order. Each of their top few records in the list are likely to be different and more suited to their strengths and duties; and rather than colliding with each other, or digging farther down the list for something more appropriate, they can get right to work from the first click.
  • Responsibility and importance information can be combined with metrics like availability (from calendars), qualification (from skills), and workload (assignments) to automatically recommend the most appropriate workers for a given record. Additionally, workers who already know the best person to handle an issue can simply nominate them.
  • When viewing worklists, workers are also given visual cues as to which records they have been recommended for. So even when two workers do indeed see the exact same records in the same order on a list, they can still click into the records that were recommended to them first, which are very likely to differ. As well, when a record requires multiple follow-ups to resolve, each time the conversation is revived, a worker who was previous recommended can handle it first. This saves new workers from wasting their time getting up to speed on the history of an issue when one of the original participants is still available. How do you know if an original participant is available? With one click, Cerb can now show you the current status, near-future availability, workload, and responsibility of those workers. In a few seconds, a worker can make a fully informed decision if a record is likely to be suitably handled by someone else, or if it needs to be nudged in a different direction.

Those changes are simple to explain, but together they provide our most efficient workflow yet, and considerably reduce collisions between workers as they find the best way to contribute.

Additionally, there are still many areas where Cerb can save even more time for workers. While observing worker actions, Virtual Attendants can learn to categorize new work, make recommendations about the best worker for each task, qualify leads with personalized follow-up questions, help troubleshoot common issues without worker intervention, suggest possible solutions to workers, etc.

Even after 13 years, it still feels like we're at the very beginning of a shift toward empowering and entrusting users with full control of the software they run. We appreciate your support for the idea that complex problems can be solved by giving people tools instead of features, openly sharing knowledge, encouraging creativity, and collaboratively iterating toward something better. Your contributions of feedback, referrals, and license renewals have helped Cerb grow into what it is today. There are billion dollar companies selling software that does a fraction of what we've all built.

- Jeff Standen, Software Architect, Cerb

Important Release Notes

Git repository URL change

We've renamed our GitHub repository so it no longer contains version names (e.g. cerb5, cerb6). GitHub automatically redirects requests from the old URL to the new one, but it's a good idea to still update your remote URLs to the new location.

First, check where your remotes are pointing now:

$ git remote -v

If you see wgm/cerb6.git in the URLs (instead of wgm/cerb.git), then you should run the following command:

$ git remote set-url origin https://github.com/wgm/cerb.git

Note: If your remote is named something other than origin, then you should use the appropriate name in the command above instead.

After you run the set-url command, you can verify the change with the first command again and you should be all set.

Configuration file changes

These changes may cause a conflict to your framework.config.php file when upgrading from 6.9 to 7.0. Before upgrading, we recommend that you make a copy of your existing configuration file (or simply rename it). That file can be used, unmodified, with the 7.0 release. After upgrading, you can either copy the database details from the old configuration file to the new one, or you can just replace the new configuration file with the old one.

  • Defaulted DB_CHARSET_CODE to 'utf8' in the framework.config.php file. If you're still using legacy 'latin1' encoding, now is a good time to convert your database to UTF-8 to properly handle multibyte languages. You can also just fix the inevitable conflicted line in this file after upgrading if you want to continue using your original settings. This new default was selected because it will match how most people are configured while causing a conflict for the least amount of people (i.e., not changing superior 'utf8' back to inferior 'latin1' on existing installs during the upgrade).
  • The language encoding in the framework.config.php now defaults to UTF-8. Previously, this defaulted to ISO-8859-1 (Western Latin) if the database wasn't originally created with UTF-8 default encoding (as MySQL's default was 'latin1'). Using UTF-8 has been our recommendation for many years. UTF-8 can be used to display the web pages even if the database continues to use latin1.
  • Removed the deprecated cache settings in the framework.config.php file since caching is now configured from Setup->Configure->Cache in the UI. You should delete these lines entirely.
  • Removed the deprecated APP_DB_DRIVER setting in the framework.config.php file since 'mysqli' is now required. You should delete this line.
  • Added APP_DB_SLAVE_* settings to the framework.config.php file. You can ignore these lines until you decide to set up master-slave database replication.


Bucket responsibilities can be configured for each group member

700 responsibilities tab.png

Group managers can now configure per-bucket responsibilities for group members. Responsibilities are displayed as a "delta" slider. By default, members have neutral responsibility for every bucket (the midpoint of the slider). By increasing or decreasing these responsibilities, actionable records (e.g. tickets, tasks) can be assigned, prioritized, and escalated to the appropriate members much more easily. Previously, all group members were considered to be fully and equally responsible for every bucket within the group.

700 responsibilities popup.png

The 'is assignable' property has been removed from bucket records, as that behavior is now handled more robustly by group responsibilities. Previously, an entire bucket was marked as containing assignable work or not. Now, each group member can be explicitly assigned responsibilities for the various buckets. Buckets with no assignees are assumed to contain non-assignable work (for the purposes of recommendations, escalation, etc).

Worklists can be sorted by responsibility

Ticket worklists can now include a 'Responsibility' column. This automatically filters the worklist to only records in buckets that the current worker is responsible for. When sorted, it considers responsibilities, importance, and record age (in descending order it's highest responsibility + highest importance + oldest).

This is the simplest way to provide personalized worklists to every team member and reduce the incidence of multiple workers attempting to work on the same record. It's our recommended workflow for discovering new work -- although, in true Cerb fashion, you are not forced to use it. You can hide the Responsibility column and continue to sort your worklists by any field you like.

700 responsibilities column.png

The order of the records in the worklist can be modified by changing the worker's bucket responsibilities, or the importance of individual tickets. Previously, tickets were often sorted in recently updated order, which inefficiently showed every worker the same exact list (and it made tickets move to the top of the list when they were edited for any reason).

Another great benefit is that workers who are only partially involved with handling tickets (e.g. developers, upper tier support) can just work until they clear their worklists of "green" (high) responsibility tickets. After that, the "gray" (neutral) and "red" (low) responsibility tickets can be left for other workers. This maximizes the impact of those workers without wasting their time having to hunt for the right places to contribute. A quick refresh of the worklist will show any new "green" responsibilities at the top of the list, without having to delve any deeper.

Service level agreement (SLA) functionality integrates with this approach very easily. You can have a worker or Virtual Attendant increment the importance of new tickets from specific contacts. The workers most responsible for those buckets (e.g. Sales, Support, Development) will be shown those higher importance tickets first (and among those, the least recently updated).


700 recommendations.png

Recommend workers for actionable records

A recommendation system has been implemented to assist human and Virtual Attendant dispatchers in assigning and escalating work. For instance, in ticket worklists, currently recommended workers are displayed along with the ability to make new recommendations. Next to each worker is a summary of their current status (online/offline), their next 24 hours of availability, their current workload (assignments, recommendations, and unread notifications), and their responsibility for the currently selected bucket.

In environments with many interchangeable workers on different schedules, recommendations are strongly encouraged compared to changing the owner of a record. In previous versions, when a record was assigned to a worker, it could disappear for everyone else. This could give the illusion of an issue being handled even if that assigned worker was unavailable. With the new system, several workers can be recommended at once, and the first to accept the work can assign themselves as the owner. The notifications for the other recommendations can be cleared (even if unread) so those workers aren't bothered to look at a record that is already being handled.

With recommendations, a worker can unassign themselves after responding so that the record is available for anyone else to handle (e.g. end of shift, vacation, etc). When workers leave themselves as a recommendation while unassigning, they will be given first priority based on their past involvement if those records need attention again in the future. Without recommendations, a different worker may be assigned for each subsequent reply, even if the original responder was currently available, which is very inefficient (as each new worker has to redundantly get up to speed with the issue before contributing).

When there are multiple recommendations on a record, the recommender system considers the bucket responsibilities, availability, and workload of each recommended worker. This makes it easy to craft Virtual Attendant behaviors that use these metrics when selecting the best assignee.

Currently, bucket responsibility is the primary metric used for recommendations. In near-future 7.x updates, recommendations can be expanded to utilize many more metrics (e.g. importance, availability, skill qualification, approachability, past involvement, lateness, etc). Most of the work is already done to collect and use these metrics, but we want to gather usage feedback based on the simpler responsibility-based implementation before making things more complicated. During development, we also had experimented with the recommender system as a learning neural network (i.e. supervised machine learning), and that's likely to be something we'll revisit in a future update.

See current recommendations on worklists

On actionable worklists (e.g. tickets), a new "Recommendations" column is displayed where the Watchers column appeared in earlier versions. For each row, a count is displayed on a button for the number of people recommended to work on that record. If the current worker has been recommended, the button will be colored green to draw their attention to it. Clicking the button displays a detailed overview of the current recommended workers, as well as the ability to add or remove recommendations.

700 recommendations column.png

The new Recommendations column can be disabled on ticket worklists from the customize action.

Ticket worklists can be filtered to records that have been recommended to a specific worker, or to those that have not been recommended to any worker. This greatly simplifies dispatching workflows.

The new "Recommendations" button is also available when replying to a ticket.

Recommendations activity is logged and triggers notifications

Activity log entries and notifications are created when a worker is added or removed as a recommendation on a record.

700 recommendations notifications.png


Public and private groups

700 groups public.png

Groups can now be marked as 'public' or 'private'. The content (e.g. tickets/tasks) in a public group are visible to non-members. This is very useful if you want only a few workers to be responsible for a group like Support, Billing, or Development, but you want all workers to have access to them. Private groups hide their content from non-members. Previously, all groups were treated as if they were private; which confused member responsibilities.

Consolidated group configuration

Previously, the management of groups was handled in three different places (Setup->Groups, the groups page, and group profiles). These areas have been merged for simplicity. New groups can be added from Setup, but they are now configured directly from the profile page. The 'groups' page (in the top right of the navigation menu) has been removed.

700 groups config.png

Inbox buckets are now actual records

700 buckets worklist.png

Group inbox buckets are now actual records in the database. Previously, inboxes were virtual records with id=0. This had simplified some early workflows since 4.0, but it also made several queries less efficient because the group had to be compared every time as well. For instance, filtering by a 'Sales' inbox would require filters like (group_id=3 and bucket_id=0) rather than just (bucket_id=5). The 7.0 update automatically creates an inbox bucket for each group and moves the appropriate tickets into it, and the configuration of Virtual Attendant behaviors, mail routing rules, and worklists will be automatically updated.

700 buckets popup.png

[CHD-2839] The group and bucket filters on ticket worklists are now independent. Previously, the group filter managed both of them. When clicking group and bucket subtotals from a worklist sidebar, only a single filter is added now. The bucket filter prefixes group names, like 'Sales: Inbox'. Filtering by inboxes now works as expected; where previously, adding a "not in" filter based on group inboxes excluded every group's inbox.

Worklists and profile pages for bucket records have been added.

700 buckets profile.png

Group buckets are now always listed in alphabetical order. Previously, buckets were manually ordered. This made it less intuitive to find a specific bucket in a list. Ticket worklist subtotals by bucket now sort properly by count.

700 buckets subtotals.png


Added a built-in importance field to ticket records

700 importance.png

A new 'Importance' field is available on ticket records. Importance is set by dragging a slider when editing tickets, rather than dealing with arbitrary labels like 'low', 'normal', and 'critical'. The importance property is used as a metric in the new recommender system and when sorting responsibilities.

Previously, prioritization was often handled using custom fields, but that approach was inconsistent between Cerb environments. Additionally, using discrete priority categories made it more complicated to create escalation workflows, where the new importance field can simply be incremented or decremented by some amount in the range of 0 to 100. This means that Virtual Attendants can just add a fixed value to the importance of new tickets for organizations with a service-level agreement (SLA), or when tickets are left idle for a certain period of time.

The importance field defaults to 50/100 (the midpoint of the slider). This allows importance to be adjusted up or down upon initial record review. When sorting by importance, this also allows new tickets to be reviewed before anything that has been set to a lower priority (where, previously, everything on the low priority end was mixed together with new tickets).

When sorting by the Importance column, the list will also sub-sort each tier of importance with the oldest tickets first (i.e. most important and oldest first).

700 importance column.png

HTML messages are displayed directly in the conversation

When reading mail, HTML messages are now displayed right in the conversation without having to click the original_message.html attachment to view them.

700 mail html conversations.png

A worker preference has been added for disabling the rendering of HTML messages and always showing the plaintext part instead. This can be found in the 'Mail' section from the 'Settings' page in the worker menu.

700 worker prefs disable html.png

Custom fields and fieldsets can be set directly on message records

Custom fields and fieldsets may now be set directly on message records. These fields are displayed at the bottom of each message in a ticket conversation (in the same format as other record properties). This is very useful for storing per-message data like customer satisfaction surveys/ratings, sentiment tracking (satisfied/dissatisfied), etc.

700 message custom fields.png
700 message display custom fields.png


Improved customization of worklists

[CHD-2422] When customizing a worklist, the process of selecting which columns to display has been drastically simplified. Previously, up to 15 dropdowns were displayed for selecting from the list of available columns. This was very cumbersome, and there was never a situation where adding the same column twice made sense. Now, all of the available columns are displayed as a list of checkboxes. Selected columns are displayed in order at the top. New columns can simply be checked and then dragged into the desired position. Additionally, this removed the arbitrary limit of 15 columns, and workers with wide screens can enable as many columns as they want.

700 worklist customize.png

Worklists can now provide specialized options in the customize section. For instance, the watchers column could be hidden or sorting could be disabled. Many people have asked for the ability to display dates in different ways based on the worklist (e.g. absolute or relative timestamps), and this makes implementing those feature requests very simple going forward.

700 worklist customize options.png

Custom worklists on workspaces can now be configured by the owner to prevent workers from changing the sorting on the list. This is particularly useful for ensuring a consistent team workflow (e.g. everyone is sorting by highest responsibilities + highest importance + oldest). Previously, the owner of a workspace could configure the default sorting but workers could always change it.

700 worklist sort.png
700 worklist nosort.png


Notifications are now directly based on activity log entries

Notifications are now more closely related to Activity Log entries. A notification message can link to multiple records (e.g. actor and target). This is also more readable since the entire notification isn't an underlined link. Previously, notifications were just a message and an arbitrary link, where the link could become stale if the record moved (e.g. Cerb install changed URLs/paths). Notifications are now based on the same events as the Activity Log. The upgrade process will automatically convert any existing notifications to the new format.

700 notifications.png

Notification worklists can be subtotaled by activity type

Notification worklists can now be subtotaled by activity type. This makes it much easier to clear out many notifications of the same type (e.g. "Worker followed a record").

700 notifications subtotal.png

Mail Transports

Multiple mail transports can be configured for delivering mail

[CHD-374] [CHD-4003] Multiple outgoing mail transports may now be configured from Setup->Mail->Transports (e.g. SMTP, Mailgun). Previously, it was only possible to have a single outgoing mail server configured for the entire Cerb installation. This change makes it easier to manage multiple brands in a single Cerb instance, where various sending domains need to use different SMTP servers or authentication methods. It's also possible to implement new transports through the plugin system to take advantage of special features like the Mailgun API (open/click tracking, campaigns, auto-unsubscribe links, etc). Each reply-to address (the addresses Cerb sends mail as) can now specify a particular mail transport to use. A default mail transport can be configured. The previously configured SMTP server will be automatically created as the new default during the upgrade process.

700 mail transports.png

Null mail transport

Added a new 'Null' mail transport. This discards outgoing mail without delivering it, which is useful for development, testing, and evaluation environments where live mail should not be delivered. Previously, the same functionality was possible by configuring a null transport in a mail server like Postfix -- or using a dummy mail server like the one provided by Python -- but those options require several extra steps. Now Cerb can simply be configured to not deliver mail, and it can be installed on test machines without needing access to a live mail server during installation.

700 mail transports null.png

Skills and Skillsets

Implemented skills for matching workers with the most appropriate tickets, tasks, calls, opportunities, etc. Skills have the following levels: none, basic, intermediate, advanced, and expert. A worker with a higher level of skill than the requirement is considered to be 'overqualified', while a worker with a lower level of skill than the requirement is 'underqualified'. A worker with the exact same skill level as a requirement is the best fit. This also provides a much more sophisticated way to automatically assign records to workers.

700 skills popup.png

Added skillsets as a way to group related skills. For instance, a Development skillset may contain skills like 'PHP', 'jQuery', and 'MySQL', while a 'Sales' skillset would contain 'Prospecting', 'Qualification', and 'Negotiation'. It's much quicker to add a single skillset to a record than trying to find and add all the individual skills. Skills in a skillset are ranked by dragging a slider to the desired level of proficiency.

700 skillsets.png

A 'Skills' tab is now displayed on worker profiles. The worker whose profile it is, or any admin, will see an 'Edit' button at the top of the tab to modify the skills and experience levels.

700 skills tab.png

Skills will be utilized by upcoming features (e.g. improvements to the recommender service).

Usability and Aesthetics

User interface style improvements

The icon style of the user interface (UI) has been modernized. Previously, we used two different sets of sprite icons. These images had conflicting styles and distracting colors which led many people to comment that the UI looked "dated". The new icons are font-based (via Glyphicons), which allows them to display cleanly at any size, and to be colorized consistently using standard CSS. They are monochromatic in color and "flat" in style.

700 ui style.png

The style of buttons throughout the UI has been improved. Button icons are now black on gray, and the labels are bold. This makes buttons more pronounced and recognizable compared to normal content.

700 ui buttons.png

The style of worklists has been improved. The list icons in the top right of the blue bar are now white (rather than multicolored). The action buttons below the list are black on gray. The peek button (shown when hovering over a row) now uses a standard "new window" icon.

700 ui worklists.png

Activity log improvements

The Activity Log and Notifications are now more personalized with "you", "yourself", and "themselves" in place of actor names. For instance "You replied to this ticket", "You assigned yourself to this ticket", "Milo recommended you on this ticket", and "Kina recommended themselves on this ticket".

700 notifications personalized.png

Installer improvements

  • The installer can now configure outgoing mail using the SMTP or Null transports. The latter makes it easier to set up development, testing, or evaluation environments where live mail isn't required or desirable.
  • When the installer creates the initial administrator account, the worker's first and last name can be provided so they don't need to change that after logging in.
  • When the installer creates the initial administrator account, the worker's timezone can be set. The initial value is automatically detected.
  • When the installer creates the initial administrator account, the worker's default calendar is now automatically created. Previously, this had to be created manually after logging in, while adding subsequent new worker accounts would automatically create those calendars.
  • Updated the aesthetics of the installer to reflect the newest Cerb style.

@mention improvements

[CHD-3995] When using @mentions to notify workers, the auto-suggestions now display each workers nickname, and filtering by that nickname (in addition to the full name) is now supported.

700 ui atmentions.png

Improved watcher functionality on worklists

The usability of the Watchers column on all worklists has been improved. Previously, each row had a button that toggled watcher status for the current worker, and a menu provided the clunky means to add or remove watchers. Now, a button is displayed row each row with a count of the workers watching the record. If the current worker is watching the record, the button will be colored green as a visual cue. Clicking on the button now displays a detailed overview of the current watchers: status, availability, workload, and responsibility for the current bucket. This new behavior is also provided from watcher buttons on peek popups and profiles, enabling more informed decision-making.

700 ui watcher buttons.png
700 ui watcher buttons popup.png

The Watchers column can now be disabled on ticket worklists from the customize action. Previously, this was always displayed, even in environments where it didn't make sense (e.g. personal webmail).

700 watchers column disable.png

Miscellaneous worklist improvements

  • [CHD-3580] The 'move' action on ticket worklists is now more efficient. Previously, this displayed a searchable menu with a long list of every group and bucket. Now it simply displays two linked dropdowns, with the first selecting a group, and the second selecting one of its buckets. This is more consistent with how groups and buckets are set in the rest of the app.
700 worklist move.png
  • Implemented 'explore' mode for group and worker worklists.
  • Implemented 'explore' mode for worker worklists.
  • The 'Group' column on ticket worklists now provides links to each group's profile.
  • The 'Bucket' column on ticket worklists now provides links to each bucket's profile.
  • The 'Owner' column on ticket worklists now provides links to each worker's profile.
  • Implemented the ability for a single worklist column to sort by a composite of any number of underlying fields. For instance, on tickets, sorting by the 'responsibility' column can sort by responsibility and then by importance.

Profile improvements

  • Worker profiles now have a tab to display their primary calendar. Previously, profiles only displayed availability, and a link displayed the primary calendar on a separate page.
700 worker profile calendar.png
  • Added keyboard shortcuts to group profiles.
  • Added keyboard shortcuts to worker profiles.

Mailbox configuration improvements

  • In Setup, changed the 'Mail->POP3 Accounts' menu option to 'Mail->Mailbox Accounts'. There can be multiple types of mailboxes (POP3, IMAP, and possibly even API-driven accounts), so naming the menu option as only one of these was a source of confusion.
700 setup mailboxes.png
  • Mailbox accounts are now first-class records with worklists, profiles, peek, etc.
700 mailbox profiles.png

Miscellaneous improvements

  • When the Gravatar plugin is enabled, profile pictures for workers and contacts are now rendered as circles rather than squares. This provides a more modern look.
700 gravatar circles.png
  • [CHD-3656] The Gravatar default icon is now served directly from Cerb. Previously, this was served from a static URL, which was triggering browser warnings for SSL connections. When the Cerb install is behind a firewall or on an intranet, the Gravatar plugin can now be configured to use any URL for the default icon.
  • Changed the default behavior of the mail reply textarea to not auto-grow as the user types new lines. This can be re-enabled from worker settings. There were numerous reports of it causing lag in some browsers, as well as causing some weirdness with scrollbar positions.
  • Fixed some usability issues with the snippets popup when composing and replying to mail. In some browsers (especially Internet Explorer) the focus of the reply textarea could be lost when inserting snippets. Additionally, when closing the snippets popup the reply textarea scrollbars could skip around and require manual repositioning.
  • Added a 'view full record' permalink to group peek popups.

Scaling and Performance

Support for master/slave database connections

[CHD-1870] Cerb now fully supports master/slave database replication setups, where writes are sent to the master(s) and reads can be distributed among many slaves. Master/slave replication has always been possible for high-availability and failover, but Cerb never took advantage of the idle slave databases for improving read performance. Previously, master/slave query splitting was only naively possible by using database proxies like MySQLproxy or MaxScale as an intermediary. Those tools simply sat between Cerb and the database and routed SELECT queries to the slaves and everything else to the master. That process couldn't handle some important types of queries that depend on deeper application knowledge (temporary tables, character encoding, etc). By handling the routing to master or slave connections directly in Cerb, we can make those decisions very intelligently while also optimizing performance.

Meta information about the database (e.g. table list, table schemas) is always read from the master to ensure that the most recent information is used. Similarly, all database queries executed by the installer and update process are sent to the master because "eventual consistency" (updates in slaves slightly lagging behind updates in the master) could cause inconsistencies. These processes run infrequently and don't have a major impact on performance or scaling. Temporary tables are created on the same connection where they're used (e.g. master for maintenance queries that modify the database, slaves for searches that join temporary tables created from external search services). All the rest of the read-intensive content -- like workspaces, worklists, dashboards, reports, and profile pages -- are almost exclusively sent to slaves. Utilizing database slaves to serve most of the content is where the major performance improvements and scalability come from.

The use of database slaves for improving read performance can be enabled by setting the APP_DB_SLAVE_* values in the framework.config.php file (host, user, password). While a single slave host can be defined in Cerb, you can put a proxy or load balancer in front of multiple slaves to scale. This could rotate between the slaves for each new connection (e.g. round-robin, least loaded, most current). Similarly, master-master replication can be utilized by specifying a proxy or load balancer for the master host. Since Cerb often generates multiple parallel HTTP requests for a single page (the outer page, a tab's content, and several worklists or widgets), multiple database slaves can be utilized to render this output more quickly.

Cerb will always route queries to either a master or slave, but when slaves aren't configured then the master serves as both roles. In this case, a single connection will be used (instead of two) to minimize wasted resources on the database server.

The database storage engine will now use the default master/slave connections when no external host is specified. The connections are also established lazily, so a slave read doesn't require that the master be contacted at all.

When Cerb caches all records for small sets (workers, roles, groups, buckets, custom fields) it will always use the master database. These caches are usually invalidated based on changes taking place in the database, and retrieving the latest record from the master ensures the most recent copy. Reading immediately from a slave could cache records prior to the change taking place if replication was slightly delayed.

Support for virtual filesystems

Virtualized the way filesystem paths work for storage and plugins. In most cases the previous way worked fine (where cerb/storage/ was the assumed path), but this change makes it possible to host multiple instances of Cerb in cloud environments where the individual storage paths aren't located at cerb/storage/. With a single site, that path could be symlinked to anywhere else; but when multiple sites share the same Cerb files, the solution needs to be at the application-level rather than in the underlying filesystem. This change makes it much easier to run and scale cloud deployments of Cerb using distributed filesystems, etc. The storage location can even change while Cerb is running and installed plugins won't be affected.

Database performance improvements

Improved the performance of several operations involving temporary tables (e.g. searching) by ensuring that primary keys were added to the temporary tables.

Removed extraneous checks for the database connection status during a single request. Database connections no longer open until they're first used, and this connection checking is now handled in a simpler way.

Prevented extraneous database query lookups when the ID of a record is zero (non-existent). These extra lookups were happening in places like ticket profiles, where organizations are looked up for senders, and the orgs may be blank.

Email address and organization records are now retrieved more efficiently with a local memory cache for the duration of the request.

Worklist performance improvements

Worklists now automatically persist worker changes (page, sort, columns, filters) and only update the database when necessary, once at the very end of the request. Previously, developers had to explicitly write a ::setView() call to persist changes. Persistence was also forced in some places in the API as well. This led to a situation where changes to a worklist could be persisted multiple times per request, even when there weren't any changes. This created extraneous write queries to the database server.

Session performance improvements

The worker activity information in "Who's Online" now only updates once per request. Previously, it was possible for multiple activities to be sequentially written to the database even though the last one would replace all the earlier ones. This created some extraneous write traffic on the database.

Previously, all worker activity for "Who's Online" was updated once per 30 seconds. This waiting period has now been extended to once per 60 seconds. When this interval was first established, there wasn't a way for some activities (e.g. viewing a ticket profile) to ignore the waiting period and always update a worker's activity. Now that this is possible, the default activity can wait longer to update in order to reduce database write traffic.

User interface performance improvements

When remembering the previously selected tab on a page, Cerb now efficiently stores this information in HTML5 localStorage in the worker's browser (client-side), rather than persisting it to the session (server-side). To the worker this behaves identically; but from a performance standpoint, this optimizes away a lot of needless session updates that wrote to the database (and possibly needed to replicate, and/or be backed up in the binary logs, etc).


Removed RSS feed functionality on worklists

Removed the RSS feed feature on ticket, task, and notification worklists. This was inherently insecure as any worker could create a feed that disclosed information outside of Cerb if the URL was known. RSS feeds can be implemented in a more secure way using the Web-API or Virtual Attendant webhook behaviors.


Added a unit testing framework

Added a unit testing framework (PHPUnit) and many new tests to the 'tests/' directory of the project. This can be used for automatically testing builds during clones, commits, pull requests, etc. Unit tests help to ensure that developers and contributors don't break existing code while implementing new features or fixing bugs. We have many testing scripts that will be consolidated here so they're accessible by the entire community. The tests are run from the command line and access to the directory should be blocked for all web traffic.

Added automated tests that create a new database, run all the patches, and add a default admin worker. This is used as the baseline for fully automated browser testing with Selenium.

Added automated browser-based functionality tests with Selenium

Added automated browser tests using Selenium to log in to a fresh installation, close the tour, add the default mail page, configure mail transports, reply-to, add a default role, add a group, create co-workers, import orgs and contacts with a CSV file, add an owner custom field to tasks, enable plugins, configure calendars, etc.

Plugin Development

Master/slave database connections

To use the new read/write splitting to master/slave databases, developers should update their plugins to use the new database functions. For instance, $db->Execute() has been deprecated in favor of ->ExecuteMaster() and ->ExecuteSlave(). Existing calls to ->Execute() will always be sent to the master. Likewise, new master/slave methods exist for ->GetOne(), ->GetRow(), and ->GetArray(). Existing calls to the generic, deprecated method will always be sent to read slaves. To optimize performance, these queries should be made explicitly as reads or writes so they can be routed accordingly.

CSS preprocessing with Sass

The cerb.css stylesheet is now built using the Sass CSS preprocessor. The source files are in the /install/extras/developers/css/cerb.css/ directory. This makes it much easier to manage the styles consistent for a large and complex application like Cerb.

Arbitrary activity log entries

Arbitrary activity log entries can be created using the 'custom.other' event point. This can be done from plugins or the REST API. In most cases, it's still ideal to explicitly define new events from a plugin. This allows them to be subtotaled, filtered, etc.

Neutral network service

Added a neural network service to Devblocks to support trainable, real-time machine learning in various features and for third-party plugins.

Maintenance updates


Cerb (7.0.1) is a maintenance update released on June 9, 2015; it contains 12 minor features, fixes, and usability enhancements from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [CHD-4096] [Mail/Parser/HTML] An incoming message with a blank HTML part will no longer generate an original_message.html attachment. This includes messages that are only whitespace with no printable characters.
  • [CHD-4107] [Worklists/Watchers/Recommendations/Usability] When clicking on a button in the Watchers or Recommendations column of a worklist, holding SHIFT will toggle the status of the current worker without having to open the popup.
  • [CHD-4105] [Groups/Responsibilities] Adding a new bucket will now default member responsibility to neutral for all active group members. Previously, these initial responsibilities were all set to zero.
  • [CHD-4104] [Worklists] Fixed an issue where custom worklists that prevent worker sorting could still be sorted by using presets.
  • [CHD-4090] [Mail/Relay] Added an option to Setup->Mail->Relay to disable the relay functionality entirely. When disabled, all relay messages are treated as incoming messages on a conversation instead.
  • [CHD-4086] [Mail/Parser] Fixed an issue where some obscure mail attachments were being saved without a name (e.g. message/feedback-report).
  • [CHD-4076] [Setup/Workers] Fixed a duplicate query issue when assigning email addresses to workers in certain conditions.
  • [CHD-3096] [Mail/Reply] Implemented a new 'Reply to only these recipients' option to the Reply menu on ticket messages. This uses the literal To:/Cc: headers from the quoted message (much like 'reply to all') rather than the ticket recipients list. This includes the From: sender in the To: line, and automatically filters out Cerb-controlled reply-to addresses (e.g. support@, sales@) and excluded recipients.
  • [Notifications/Virtual Attendants] Added a 'url' placeholder back to notification-based Virtual Attendant behaviors.
  • [CHD-4119] [Mail/Profiles] Fixed an issue where the 'read all' preference on ticket conversations wasn't being utilized properly.
  • [CHD-4120] [Mail/Usability] The order of the 'Recommended' and 'Watching' buttons is now consistent between worklists, profiles, and peek popups.
  • [CHD-4084] [Virtual Attendants/Files] In Virtual Attendant behaviors, the 'Send email' and 'Send email to recipients' actions can now attach files to outgoing messages using file bundles.


Cerb (7.0.2) is a maintenance update released on June 23, 2015; it contains 11 minor features, fixes, and usability enhancements from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [Updater] Fixed an issue in the updater when upgrading from a version prior to 6.1 directly to 7.0+.
  • [Code Cleanup] Fixed a MySQL warning when deleting reply-to addresses.
  • [Web-API/Search/Custom Fields] When searching records through the Web-API, the results can now be sorted using custom fields.
  • [CHD-4126] [Install/Windows] Fixed an issue when installing Cerb on Windows. in some environments, the installer stops at step #5 with a blank screen. This was caused by inconsistent directory separators in various builds of PHP on Windows.
  • [Knowledgebase/Custom Fields/API] Custom fields and fieldsets now work properly on knowledgebase article worklists and through the API.
  • [Profiles/Workers/Responsibilities] Fixed an issue on worker profiles where the Responsibilities tab always displayed data for the logged in worker rather than the displayed one.
  • [Setup/Workers] Fixed an issue with worker worklists that prevented the (+) add icon from working properly.
  • [Workspaces/Dashboards/Pie Charts] Pie chart widgets on dashboards now properly load series-based data from URLs in JSON, XML, or CSV formats.
  • [CHD-4129] [Workspaces/Dashboards/Pie Charts] When a pie chart widget loads data from URLs in JSON or XML format, a 'label' property can be given to describe the subset.
  • [Workspaces/Dashboards] When using the 'URL' datasource on dashboard widgets, an option is now available to explicitly specify the format of the data (e.g. auto, JSON, XML, CSV, plaintext). Previously this was always auto-detected, but could cause problems if a web server returned the wrong content type header.
  • [CHD-4128] [Setup/Workers/Groups/Responsibilities] When adding new workers, their responsibilities will default to the midpoint for all buckets in their group memberships. Previously, these were being defaulted to no responsibilities at all, which confused new workers.


Cerb (7.0.3) is a maintenance update released on July 27, 2015; it contains 20 minor features, fixes, and usability enhancements from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [CHD-4142] [Mail/History/Usability] When clicking into a ticket profile from a worklist, the Timeline/Conversation tab will now always be displayed first. When using next/previous in Explore Mode, the currently selected tab will continue to be used (e.g. cycling through many ticket histories or audit logs). Previously, as of the 7.0 update, clicking into a ticket profile from the Recipient History tab on another ticket would display the History tab first on the next record (because viewing the tab set it as the default).
  • [CHD-4141] [Worklists/Customize] Fixed an issue where a worklist configured to display no additional columns would display the record's default columns instead.
  • [CHD-4135] [Worklists/Subtotals/Mail] Ticket worklists can now be subtotaled by 'Bucket' directly. Previously, the 'Group' option totaled groups with nested buckets within each group. This made it difficult to use bucket counts on dashboard pie chart widgets, etc.
  • [CHD-4121] [Virtual Attendants/Record Changed] Fixed an issue in Virtual Attendants with 'Record changed' behaviors where the 'old_' placeholders of custom fields weren't being loaded properly if no custom fields were currently set on the record. In this situation, the 'old' and 'new' placeholders for all custom fields were the same. The 'old' placeholders are now properly defaulted to null values.
  • [Search/Worklists] Fixed an issue where some search and chooser worklists defaulted to displaying no columns.
  • [Search/Mail] The search worklist for tickets now hides the recommendations column by default. This allows all records to be searched, rather than only those in the current worker's responsibilities.
  • [CHD-4148] [Calendars/Workers] Fixed an issue where deleting a worker didn't also delete their owned calendars.
  • [Updater] Fixed an issue where the 'Mailbox Checker' scheduled job wasn't added in some environments. This will be added retroactively if it's missing.
  • [Updater] Fixed an issue when upgrading directly to 7.x from versions prior to 6.5. If Virtual Attendant behaviors were owned by missing records (e.g. deleted groups/roles/workers), then the update aborted when applying the 6.5.0 migration patch.
  • [Code Cleanup] Fixed a PHP error when viewing the profile of an invalid group.
  • [Scheduler/Import] Fixed an issue in the 'Import' scheduler job. When an importing record describes a new Group or Bucket, it was possible for the bucket to be created multiple times. If the bucket was 'Inbox', this was already being created in 7.0+ when the new group is created, but it wasn't being recached. This should all work properly now.
  • [Mail/HTML] Fixed an issue with displaying HTML messages that contain malformed CSS stylesheets. In some cases, these were causing an infinite loop where the 'Loading: Timeline' tab never completed.
  • [CHD-4164] [Virtual Attendants/Workers] Fixed an issue with Virtual Attendant 'Set worker' actions when using the 'round robin' option. This option could behave erratically when conditions on the behavior skipped the action in some situations (e.g. only pick a record owner if there is no current owner). This led to workers seemingly being selected out of order, one selected twice in a row, etc. This should behave as expected now.
  • [Virtual Attendants/Worklists] Fixed an issue with 'Set list variable' actions on Virtual Attendants. When reopening a worklist data source, the previously selected filters weren't being displayed correctly.
  • [Mail/HTML/Usability] Optimized the way large and/or complex HTML messages are displayed. Previously, relatively small but complex messages (like those generated by Microsoft Office) could exhaust the available memory in PHP if the memory_limit was low enough (sometimes even at 128MB). This resulted in a 'Loading: Timeline' message on a ticket that never completed.
  • [Mail/HTML] When displaying HTML formatted messages in the conversation history of a ticket, needlessly complex Microsoft Office markup will be removed automatically if the 'Tidy' extension is installed and enabled in PHP. For some test instances, this reduced 1.9MB HTML messages to 183KB. On the same message, Cerb's generated plaintext part was only 39KB.
  • [Mail/HTML] Fixed an issue with displaying HTML messages that contain a large amount of CSS in a <style> block (e.g. 20KB+). In some environments, the PHP process could die in a regular expression in the CssToInlineStyles library intended to strip @media queries. This has been reported to the project and we're using a workaround.
  • [CHD-4172] [Import/Scheduler] Fixed an issue in the 'Background Import' scheduler job that prevented attachments and comments from importing properly on tickets.
  • [Worklists] Fixed an issue with custom worklists on a workspace when the 'In groups of worker' filter referenced a deleted worker. This could prevent the worklist/tab from displaying.
  • [Virtual Attendants/Simulator] Fixed an issue in the Virtual Attendant simulator when a behavior variable is also a condition in an outcome. The same behavior variable then shows up in both the 'Parameters' tab and the 'Conditions' tab, and the latter always takes precedence (and is usually blank), which ends up ignoring the given value. Now a given field will only show up in one tab or the other (giving precedence to the Parameters tab).


Cerb (7.0.4) is a maintenance update released on August 17, 2015; it contains 8 improvements (minor features, fixes, usability enhancements, and a security patch) from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [CHD-4155] [Mail/HTML/Usability] When displaying HTML messages on tickets, external links will now be displayed in a new browser tab/window. Previously, these were replacing the current page in Cerb unless the worker knew to hold CTRL/CMD when clicking the link.
  • [CHD-4145] [Virtual Attendants/Mail] The 'Send email' action in Virtual Attendants can now override the 'From:' and 'Subject:' headers. This allows VAs to spoof sender addresses if the SMTP transport allows it, which enables behaviors like automatically forwarding/reflecting messages to a different destination.
  • [CHD-4171] [Sessions/Activity Log] When the seat count is reached and a worker is logged out, the event will be recorded in their activity log for later auditing.
  • [Code Cleanup] Fixed a PHP Notice regarding a 'conntinue' typo.
  • [CHD-4161] [Virtual Attendants/Headers/Usability] When using 'Message headers' conditions in Virtual Attendant behaviors, the header name may now be given with or without a trailing colon. Previously, if the header name was followed by a colon the condition always failed.
  • [CHD-4173] [Worklists/Customize/Options] When customizing a worklist, fixed a namespace issue with two different sections using the 'options' field name. For instance, if a picklist custom field was being displayed in 'Add filter', then the view options (e.g. hide watchers/recommendations/sorting) didn't save properly.
  • [CHD-4180] [Mail/Groups] Fixed an issue when sending mail where the 'From:' personal name didn't cascade properly. If the bucket and group's default bucket lacked a personal sender name, the default bucket's reply-to wasn't being checked before the global default reply-to was used.
  • [Security/CSRF] Fixed a medium risk CSRF (cross-site request forgery) vulnerability reported by High-Tech Bridge (HTB23269). We don't have any evidence of this having taken place in the wild, but we were able to reproduce the results with the proof-of-concept in the advisory. A logged in worker could be tricked into visiting a URL that could perform certain actions in their browser session. Cerb now uses the Synchronizer pattern: a session-based token included with every HTML FORM and Ajax request that is compared to the active session. This verifies that such requests are coming from an existing Cerb page rather than an external source. When a potential CSRF attack is detected, the event is now logged in the PHP log as a warning.


Cerb (7.0.5) is a maintenance update released on September 2, 2015; it contains 19 improvements (minor features, fixes, usability enhancements, and a security patch) from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [Worklists/Export] Fixed an issue where exporting records from a worklist could change its underlying display columns and length.
  • [Security/XSS] Fixed a potential cross-site scripting (XSS) vulnerability in the chooser popup. If HTML markup (e.g. script tags) existed in the text of a records link, then they were evaluated when the chooser popup opened or when those rows were selected. This was due to the links being converted to bold tags without escaping their content, which bypassed the normal sanitization in the rest of Cerb.
  • [Web-API/Knowledgebase] Implemented an 'expand=categories' option for knowledgebase articles in the Web-API. This returns breadcrumb trails for all the categories the article exists in. Redundant categories paths are automatically removed. For instance, if an article exists in categories A, A->B, and A->B->C, only A->B->C will be shown since A and A->B are already part of that path.
  • [CHD-4208] [Installer/Updater] Fixed a SQL error when upgrading directly from a version prior to 6.6 to a version prior to 7.0.5. This was harmless, but it could cause output to occur before the headers were sent in some environments, which prevented the update process from redirecting to the login form.
  • [CHD-4123] [Installer] Fixed an issue in the installer where the worker's first and last name were reset if there was an error with the form (e.g. passwords didn't match).
  • [CHD-4127] [Notifications/Sticky Notes] When viewing a ticket profile, message-based notifications (like sticky notes) are now also displayed and automatically marked read.
  • [CHD-4137] [Profiles/Notifications] Fixed an issue on profiles where notifications weren't always listed in reverse chronological order (e.g. newest first).
  • [Usability/Worklists] Slightly reduced the contrast of idle (gray) watcher/recommendation counter buttons in worklists. This fades them out a little so the green highlighted buttons are more apparent.
  • [CHD-4158] [Reports/Worker] The 'Worker History over Date Range' report no longer includes broadcasted messages in the totals.
  • [Reports/Workers] Improved the 'Average Response Time' worker report. Previously, the report attempted to calculate response times itself. Now it simply uses the 'response time' field that we already track and display on conversations (since 6.1 in Aug 2012).
  • [CHD-4174] [Groups/Buckets] Fixed an issue where non-admin group managers couldn't edit bucket properties.
  • [CHD-4183] [Web-API/Mail] Fixed an issue with the tickets/compose and tickets/reply API calls where the 'reopen_at' option wasn't working properly. It can now contain a string ("tomorrow 2pm", "+2 hours") or integer (unix timestamp) value.
  • [CHD-4176] [Support Center/Contact] Fixed an issue when configuring the contact situations in the Support Center. The labels for custom fieldsets weren't displaying for new contact situations until they were saved.
  • [CHD-4187] [Activity Log/Worklists] Fixed an issue on Activity Log worklists when filtering by more than one actor or target. This was making some filters optional. For instance, filtering by "activity = worker logged in" and "worker is Kina or Janey" could show more than just 'logged in' activities.
  • [CHD-4201] [Mail/Broadcast/Reply] Fixed an issue with the 'broadcast reply' option in bulk update on ticket worklists. The broadcast preview wasn't filling in placeholder values.
  • [CHD-4206] [Worklists/Usability/Performance] Fixed an issue with worklists where some customizations weren't being saved properly. If a worklist had the same ID as its default, the worklist was constantly overwritten by the default. This was noticeable with lists like Setup->Storage->Attachments, but it also created extra queries elsewhere by persisting the default worklists even if they were never used.
  • [CHD-4205] [Setup/Mailbox/Usability] Corrected a minor inconsistency in Setup->Mail->Mailboxes. The column label for 'Max message size (KB)' on the worklist had the explicit 'KB' suffix, but the values are automatically scaled (e.g. bytes, KB, MB, GB). The column label now just refers to 'Max Message SIze'.
  • [CHD-4078] [Security/Worklists/Export] Fixed an issue where exporting a worklist could bypass a worker's group permissions.
  • [CHD-4200] [Mail/Compose/Usability/Shortcuts] Implemented keyboard shortcuts on the mail compose popup. From the textbox, the status can be set with Ctrl+Shift+ O (open), (W) waiting, or (C) closed. The 'send' button can be focused with Ctrl+Shift+Enter.


Cerb (7.0.6) is a maintenance update released on October 14, 2015; it contains 10 improvements (minor features, fixes, usability enhancements, and a security patch) from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [Web-API] Fixed an issue with the workspaces/pages/list.json API request. This was filtering out too many pages, when it should have been returning workspace pages and discarding everything else.
  • [Mail/HTML] Fixed an issue when displaying HTML messages and the underlying storage object is missing. Now the plaintext is displayed as a seamless fallback. Previously, these messages were appearing blank, or with a cryptic XML header.
  • [Security/Snippets] Fixed a potential XSS vulnerability in the snippets chooser. The name of a snippet was being evaluated as HTML (including script tags) when converted from a link to normal text. These labels are now properly escaped. This was a very unlikely attack vector since snippets are managed by workers and don't contain any user-provided content.
  • [Code Cleanup] Added a default entry for the DEVELOPMENT_ARCHIVE_PARSER_MSGSOURCE option in the framework.defaults.php file.
  • [CHD-4219] [Search/Messages] Fixed an issue where message worklists could become stuck using stale group membership information for the current worker, making it impossible to locate some messages. The 7.0.6 upgrade script will automatically fix any worklists with this issue.
  • [Search/Messages] Implemented an 'In Groups of Worker' filter on message worklists. This filters based on the group memberships of the given worker.
  • [Mail/HTML] Fixed another issue with Microsoft Office formatted HTML messages where the 'Timeline' never displayed any content.
  • [Mail/HTML] If an HTML message source is greater than 1MB, then the plaintext part is now automatically displayed in ticket timelines. The original content can still be viewed from the original_message.html attachment. This resolves some 'out of memory' issues in the HTML sanitization code.
  • [Translations] Fixed an issue with translations not working when MySQL was in strict mode. When this occurred, only the translation keys were displayed, like "common.login".
  • [CHD-4186] [Workspaces/Dashboards] Fixed an issue where placeholders in dashboard widgets were converted to static filters (e.g. current_worker_id -> 1).


Cerb (7.0.7) is a maintenance update released on November 16, 2015; it contains 7 improvements (minor features, fixes, usability enhancements, and a security patch) from community feedback covering the recent 7.0 update. You can follow these instructions to upgrade.

  • [CHD-4186] [Virtual Attendants/Relay] Improved the 'Relay to external email' action in app-owned 'Custom ticket' behaviors. Previously this was only allowing the current worker as a relay target, rather than all workers.
  • [Mail/HTML] Fixed some more display issues with Microsoft Office formatted HTML messages. In these cases, the Timeline tab's loading spinner ran indefinitely because Tidy had crashed the PHP process.
  • [Mail/HTML Templates] Fixed a bug when deleting an HTML Mail Template. This was still attempting to unlink it from any group records, when templates are only associated with buckets and reply-to addresses in 7.x.
  • [Platform/Plugin Library] Fixed an issue with the DevblocksPlatform::strVersionToInt() method where a version like '7.1' (rather than '7.1.0') would result in the int '701' rather than '70100'. This caused problems with updating plugins in the Plugin Library.
  • [Profiles/Ticket] Fixed an issue that prevented the 'updated date' field from displaying in the properties of a Ticket profile page.
  • [Virtual Attendants/Variables] Fixed an issue in Virtual Attendants where the 'Remove these objects from the variable' option of the 'Set variable' action didn't properly remove the given objects from the variable.
  • [Setup/Support Center/Templates] Fixed an issue in Setup->Configure->Portals when exporting a set of custom templates from a portal. In newer versions of PHP this gave an error along the lines of "Only variables should be assigned by reference".