Blog User Guide Documentation API Login Register

Documentation > Getting Started

Updating

Last updated February 16, 2024

Updating To 5.1 From 5.0

Estimated Update Time: 2 Hours

Note

We attempt to document every possible breaking change. Since some of these breaking changes are in obscure parts of the CMS, only a portion of these changes may actually affect your website.

Categories Module

Repositories have been ripped out of the categories module

Please ensure that you are not referencing any of the repository-specific methods and properties when using the category helpers.

category_entries() helper method has been removed

In line with removing the repository interface within categories, we've updated the way category entries need to be queried.

When piggybacking off of the matrix_entries() helper method, you now have access to a new underCategory() method. This will query the results of your entries down to the category and category group handle's specified:

// Get all entries under the category with a handle of "space-sloth" regardless of the category group
$entries = matrix_entries('blog')->underCategory('space-sloth')->get();

// Get all entries under the category with a handle of "nuclear-rabbits" under the category group "pets"
$entries = matrix_entries('blog')->underCategory('nuclear-rabbits', 'pets')->get();

Users Module

The "Your Account" URL has been changed

The URL has changed from /settings to /account.

Furthermore, each section of the account management interface have been extracted to their own endpoints with their own templates:

Page URL Originating View
Overview /account users::account.index
Profile /account/profile users::account.profile
Change Password /account/password users::account.password

Themes Module

The underlying theming framework has been updated.

Reference to Theme Namespace

You are no longer required to reference your theme's namespace when referencing view files.

Performing a find and replace on your theme's namespace to remove should suffice in this update (e.g. search for example:: in your view templates where example is the namespace of your theme).

Renamed theme_layout() helper method

The theme_layout() method has been renamed to be simply layout(). Please ensure that your @extends blade directive calls have been updated.

Furthermore, if you are still using the Theme::getLayout() method or $theme_layout variable, please update this to reference layout() as well.

Matrix Module

Repositories have been ripped out of the matrix module

Please ensure that you are not referencing any of the repository-specific methods and properties when using the matrix helpers.

Deprecated Repository Methods

For further documentation on the methods available to you with this update, please refer to the Laravel documentation here: https://laravel.com/docs/5.4/eloquent

From To
helper_method()->model helper_method()->
helper_method()->findAll() helper_method()->all()
helper_method()->findBy() helper_method()->where(...)->first()
helper_method()->findWhere() helper_method()->where([...])->get()
helper_method()->findWhereBetween() helper_method->whereBetween(...)->get()
helper_method()->findWhereIn() helper_method->whereIn(...)->get()
helper_method()->findWhereNotIn() helper_method->whereNotIn(...)->get()