Aptuitiv Releases

Theme editor color palette improvements

We recently added a few additions and improvements to the Color Palette feature in the theme editor.

1. There is now a menu button (the 3 vertical dots) next to each color palette item that lets you insert before, insert after, move to first, or move to last position. While you can still drag items up and down, this is a nice addition when you're adding to a large list. Font palettes also got this feature.
2. Search the color palette.
   On the color palette section you can now search by the color value or the color label. Helpful when you have a lot of colors in the palette.
   You can also search the color palette when you're selecting a color in the color picker. When you choose the color palette option there is a search box at the top of the palette list that gets focus.
3. Add a color to the color palette from the color picker. 
   If you're editing a color elsewhere in the theme editor, you can now set that color to be part of the color palette right from the color picker. Go to the Palette section of the color picker and click on the "Add to palette" button at the bottom. You can set a descriptive name and set the display order (it defaults to last).
4. Edit an existing color palette color from the color picker.
   When you're editing a color elsewhere in the theme editor, you can update an existing color palette value to be the value from the color picker. Go to the Palette section of the color picker and click on the "Update a color" button at the bottom. You can then select which palette color to update.
5. Set a palette color to reference another palette color.
   If you've really taken advantage of the color picker then you may have a core set of colors and then reuse those colors in multiple palette colors. While this is fine, it adds more work if you ever want to change that core color. Now, a palette color can reference another palette color. When the parent color changes, all child colors are automatically updated, even when used in color pickers elsewhere. Up to ten levels of reference are supported, although that will get complicated to keep track of so we recommend trying to just link to a core set of colors.

Bulk apply page password protection configuration

When you're viewing the list of pages in the administration you can now bulk set pages to either be password protected or not password protected.

Here is how you do this:

1. Go to Content -> Pages
2. Click the checkbox next to one or more pages
3. Click on the Bulk Edits table toolbar item and then Password Protect
4. Configure the password protection and save the settings.

Change the name of the Blocks template folder

In the old administration, Blocks were called Content Builder Elements (a mouthful, we know). Blocks are a much better name and more understandable in the industry.

But, the template folder for blocks has been stuck at the legacy 'content-elements' name.

We just added support to change it to 'blocks' to match the terminology that is currently used. Go to Settings -> Theme to make this change.

When the folder is changed you will be prompted to also move your template files. If you approve of that change, the system will move the template files for you. But, you'll also want to update your local code so that it reflects this change.

Customize where Collection Widget items can be displayed

If your website is displaying a collection widget on all pages, you can now limit which pages it will show on without having to change your templates.

A practical example is if you're using a collection widget to show a notification banner at the top of all pages. Or, if you're using it to show a popup message. You don't always want those to show on all pages.

In the past you'd have to customize where a collection widget showed in the site templates.

Now, all collection widget items can be individually customized to set where they show. There are a few different options:

1. Show it on all pages. This is the default.
2. Limit to specific pages and/or URL patterns.
3. Show everywhere but specific pages and/or URL patterns.
4. Show on the home page only.

You can select specific pages or app pages to show or hide the item on. You can also set URL patterns to apply to a group of pages. The following patterns can be used:

• URL starts with
• URL contains
• URL ends with
• Exact URL
• URL path with wildcards

You can set the visibility for collection items when adding or editing an individual item. You can also bulk apply visibility settings to multiple items at the same time from the table of items.

You can also set a default visibility configuration when you add or edit the collection itself.

View Content Layout usage

You can now easily see what is using a Content Layout. To do so, click on the Content Layout to go to it's detail page. There is now a "Usage" tab. Clicking it will show if there are any pages, content snippets, or page template configurations that use the Content Layout.

Storage app payment information updates

We added a few updates to the Storage app regarding payment information.

• When bulk processing invoices, it will now show you why a customer was not included in the list.
• Anywhere customers are show in tables (like the customer table, invoices, or subscriptions) the table will now include information about the primary payment method the customer has. This makes it easier to see if a customer has a payment method on file.
• Invoice tables now show the status of the subscription that the invoice is for. You can also filter by the subscription status.

Breadcrumbs now have their own Twig template file

This is a small improvement, but one that will help developers. The breadcrumb template has historically only been saved in the website database, but now it is also saved as a Twig template file. This means that you can track it in GIT with the rest of your templates. It gets saved to "site/breadcrumb.twig" within your theme templates folder.

Modals are now draggable and resizable

Modals, also knows as "pop ups" are used a lot in our CMS software for showing additional fields and content to update. Previously they displayed centered on the page and you couldn't change that.

Now you can drag modals around on the page by clicking the dark title bar at the top and moving your mouse around. (You can also hold down Option+Shift and use the arrows to move it around.) If the same modal is reopened then it will remember it's last position.

You can also resize modals by dragging on the left, right or bottom edges. Or drag from the bottom-right or bottom-left corners.

This is a small update, but really useful if the modal is covering up something you need to reference while working in the modal.

App item URLs in the app item table

The Pages app has shown the URL of the page below the page name for a while. Now all app items do too. 

This is useful in a few ways including:

• Easily see what the URL is for the item in case you need to change it.
• You can now filter the table by the item URL to find specific items. Useful for finding an item to update when doing an SEO or accessibility audit.

Storage App Improvements - Balances & UI Improvements

Multiple improvements to the Storage app in this release.

Fixed calculating the initial rent period

Fixed an issue with calculating the correct number of initial months to rent when it's more than 1 month. We allow setting an initial rental period to be more than one month, and sometimes the initial rent period wasn't calculated correctly. Now it is.

New setting to force renting whole units of the initial rent period

To help ensure the ideal initial rental period, we added a new setting called "Should the initial rent period be rounded up to the nearest whole number of periods?".

If that's set to "Yes", then the initial rent period will always be at least 1 month, 2 months, 3 months - whatever the initial rent period is configured to.  This allows the initial rent period to always be a minimum of the configured rent period, or prorated so it's close. 

If a storage company has an initial rental period of 1 month, they likely want this off so that someone renting in the beginning of a month isn't charged almost two months. But if you've configured the initial rental period to be more than 1 month, you likely want to turn this on because you likely want the initial period to be at least 2, 3, or whatever number of months you picked. If it's turned on then it'll be the number of months + a prorated amount for the remainder of the current month.

Rental settings now show a preview of the initial rental period

To help make sure your initial rental period is calculated correctly, there is now a "Preview of initial rental periods" accordion that you can toggle to show a preview of what the renewal date would be for rents starting each day of the current month.

Invoice balances now include late fees

To help you see what is owed, any time you see a balance for an invoice, it will include any late fees. All of the different detail pages are updated, as well as the payment form and the form to apply a manual payment.

The customer detail page also shows a total open balance for the customer if they have one.

The "Record payment" form now supports recording late fee payments. Previously, it only showed the open balance for the invoice. Now it includes late fees too.

Updates to adding a payment method

The form for adding a payment method for a customer has been updated to use the latest code from Stripe. This updates the user interface a little bit and hides Stripe Link from showing.

Transactions now show more payment information

Transactions now show more information about how a payment was made (like the credit card type and last 4 digits) and link to the transaction in Stripe. The Stripe link is useful if you need to do any troubleshooting or need to refund. (We have refunds planned as a later update.)

Customer detail tabs now have action buttons

Each tab on the customer detail page now has an "Add" button to add the thing the tab is about. (Transactions are the exception because they are added by the system when a payment is made or attempted.) While the same actions could be done in the "Actions" button menu in the top right, this puts the "Add" action in more context in the tab.