Release Notes

Botble 5.21

Sep 14, 2021

  • Fix theme migration & issue when activating plugin Language.
  • Fix admin email.
  • Fix cache issue in media.
  • Improve theme custom CSS/JS.
  • Improve plugin Member, Blog & Newsletter.
  • Improve allowed iframe types.
  • Handle TokenMismatchException.
  • Prevent error when missing watermark image.
  • Update to the latest Laravel version 8.60.0
  • Improve core.
  • Optimize queries performance.

Botble 5.20

Aug 23, 2021

  • Fix social login.
  • Fix editor in Custom Fields.
  • Fix Contact plugin with the new editor.
  • Improve shortcode. Make it easier to modify added shortcodes.
  • Improve editor & clean XSS.
  • Update to the latest Laravel version 8.55.0
  • Improve core.
  • Optimize queries performance.

Botble 5.19

Jul 27, 2021

  • Update CKEditor and TinyMCE to the latest version (version 5).
  • Update media: Add a button to download media files from URL.
  • Able to add multiple admin emails in Admin -> Settings -> General.
  • Big change on blog categories. Hierarchical tree structured category

Botble 5.18

Jul 11, 2021

  • Add Wasabi cloud storage support.
  • Allow to config the default placeholder image.
  • Improve media, translations & backup.
  • Improve UI.
  • Optimize queries.
  • Refactor code & improve performance.
  • Fix some bugs on PHP 8.

Botble 5.17

Jun 13, 2021

  • Added RTL support for the admin panel.
  • Fix some errors on PHP 8.
  • Fix blog API.
  • Improve media, fix some errors with SVG.
  • Improve UI.
  • Optimize queries.
  • Refactor code & improve performance.

Botble 5.16

May 10, 2021

  • Fix change user's password.
  • Remove unused services in Google Client API services to reduce app size.
  • Fix color field.
  • Update theme options & handle errors when saving custom CSS.
  • Optimize queries.
  • Refactor code & improve performance.

Botble 5.15

Apr 07, 2021

  • Add option to turn off automatic URL translation into Latin.
  • Add command to rename the theme to the new name.
  • Add option to force URL & schema.
  • Improve email templates.
  • Fix bug Serialization of 'GdImage' is not allowed.
  • Refactor code & optimize performance.

Botble 5.14

Mar 02, 2021

  • New option to add custom JS in Admin -> Appearance -> Custom JS.
  • Added setting in Admin -> Settings -> General to change login screen backgrounds.
  • Improve dashboard widgets.
  • Improve page SEO meta.
  • Improve Blog API (prevent error when sending wrong params).
  • Improve breadcrumbs.
  • Fix permission issue on Contact plugin.
  • Fix field File in Custom Fields plugin.
  • Fix some bugs on PHP 8.

Botble 5.13

Feb 04, 2021

  • Upgraded to Laravel 8.
  • Update JS/CSS assets.
  • Improve admin language settings.
  • Improve permalinks.
  • Fix language plugin.
  • Fix bugs on PHP 8.
  • Refactor code & optimize UI.

Botble 5.12

Jan 19, 2021

  • Update seeders.
  • Update error pages, make it more simple.
  • Improve UI gallery images, update Google fonts & fix cookie consent.
  • Improve media URL.
  • Improve core & optimize queries.
  • Remove theme NewsTV.
  • Remove unused CSS/JS libraries.
  • Fix postCSS, upgrade to Laravel Mix 6.0
  • Fix responsive for tables on Member dashboard.

Botble 5.11

Dec 11, 2020

  • Improve Cookie Consent plugin.
  • Improve responsive.
  • Update translations, added missing keys.
  • Improve DO Spaces integration.
  • Fix roles & permissions.
  • Update UI for Ripple theme.
  • Update seeders, easy to generate sample data using command db:seed.
  • Update setting page & system info.
  • Optimize page speed and performance.

Botble 5.10

Nov 14, 2020

  • Update menu: optimize queries, cache menu URL for better performance.
  • Optimize queries on menu & widgets.
  • Update Cookie consent: Add option to change background color, text color.
  • Update error pages, make it more beautiful.
  • Update UI contact form, galleries.
  • Improve permalink & custom CSS page.
  • Improve Analytics plugin, make it compatible with PHP 7.4.
  • Fix theme translations: new keys in English doesn't show in other languages.
  • Fix IP in activity logs, allow IP v6.
  • Add seeders: easy to create sample data with command php artisan db:seed.
  • Add command to activate all plugins in one time: php artisan cms:plugin:activate:all
  • Add functions to get popular blog categories.
  • Add mediaImages fields.
  • Refactor code.

Botble 5.9

Oct 15, 2020

  • Fix multi-language with Ajax.
  • Fix views count.
  • Update contact form with Ajax.
  • Update email encryption settings.
  • Improve Recaptcha: add an option to hide the v3 badge.
  • Improve export posts to CSV, Excel.
  • Apply PurgeCSS to remove unused CSS, make it loads faster.
  • Improve theme UI.
  • Refactor code.

Botble 5.8


  • Update to Laravel version 7.28
  • Update homepage & blog page settings. Now, it's moved into Appearance -> Theme options.
  • Move settings for Cookie Consent into Appearance -> Theme options.
  • Add theme options to enable/disable Facebook chat, Facebook comment.
  • Add settings for watermark. Now, you can add watermark by changing setting in Admin -> Settings -> Media.
  • Allow to change permalink in Admin -> Settings -> Permalinks.
  • Add language settings. Allow to set default language in Admin -> Settings -> General.
  • Allow admin to login using email or username.
  • Optimize queries to make site loads faster.
  • Update UI.
  • Refactor code.
  • Fix webpack.mix.js config, issue with path on Windows.
  • Fix assets path.
  • Fix copy folder in Admin -> Media.

Botble 5.7


  • Upgrade to the latest Laravel framework version 7.22.
  • Deprecated some media functions: is_image, get_image_url, get_object_image, rv_media_handle_upload. Replacements: RvMedia::isImage(), RvMedia::getImageUrl(), RvMedia::handleUpload().
  • Add theme options to change primary color.
  • Add support Digital Ocean Spaces.
  • Send an email to admin when someone create a new post.
  • Fix timezone, it doesn't work before.
  • Fix filter posts.
  • Update email settings. Add support SES, Postmark, Array, Log.
  • Improve performance & refactor source code.
  • Improve license system, make it works better.

Botble 5.6


  • Update to the latest Laravel version 7.18.
  • Optimize database queries.
  • Add support Recaptcha v3.
  • Improve cookie consent.
  • Fix bugs plugin Language & Custom fields.
  • Add default open graph image.
  • Improve dev tools.
  • Improve admin UI.
  • Refactor code.

Botble 5.5


  • Update to the latest Laravel version 7.13.
  • Improve media module: support upload chunk size.
  • Improve email system.
  • Update API package.
  • Move js-validation package to core.
  • Upgrade jQuery to v3.5.1 and Bootstrap 4.5.0.
  • Improve admin UI.
  • Refactor code.

Botble 5.4


  • Update to the latest Laravel version 7.8.
  • Refactor code & optimize performance.
  • Add backup commands:
    • php artisan cms:backup:create
    • php artisan cms:backup:restore
    • php artisan cms:backup:remove
    • php artisan cms:backup:list
  • Fix image's watermark.
  • Change default avatar, remove Gravatar as default avatar.
  • Fix widget & plugin language.
  • Remove package davejamesmiller/laravel-breadcrumbs, build own breadcrumbs.
  • Fix bug repeater field in plugin Custom fields.
  • Fix theme options when using editor field.

Botble 5.3


  • Update to the latest Laravel version 7.3
  • Improve source code.
  • Add plugin Translation.
  • Improve plugin custom fields.
  • Improve plugin language. When add/remove a language, it also adds/removes language files in /resources/lang.
  • Update UI.
  • Refactor code.

Botble 5.2


  • Upgrade to Laravel 7.x
  • Improve source code.
  • Add package js-validation & sitemap
  • Fix context menu in media.
  • Fix bug when changing admin's password.
  • Improve plugin custom fields.
  • Update translations.
  • Update UI.
  • Refactor code.

Botble 5.1


  • Update admin theme.
  • Improve source code.
  • Update member activity logs.
  • Fix media upload.

Botble 5.0


  • Change admin theme to make it more awesome.
  • Add license.
  • Update ckeditor to allow to add image's caption.
  • Fix ACL module.
  • Fix account plugin.

Botble 4.2


  • Fix bug upload avatar in plugin member.
  • Fix permission issue when changing language.
  • Fix dev commands.
  • Fix error when creating new role.
  • Fix page title.
  • Fix logo in email.
  • Fix menu & audit log.
  • Fix sort order in dashboard widgets.
  • Update UI in login/register form for member.
  • Update plugin social login to support plugin member.
  • Update country flags.
  • Update latest code from Laravel framework.
  • Deprecated function setModuleName() in forms.
  • Using package mews/purifier to prevent XSS attack.
  • Add plugin cookie consent.
  • Refactor code.

Botble 4.1


  • Fix bug in plugin member.
  • Improve custom fields.
  • Improve media.
  • Change to use laravel/tinker 2.0
  • Change to use mpociot/laravel-apidoc-generator 4.0
  • Add command php artisan cms:plugin:make:crud (Video tutorial:
  • Fix UI
  • Add config for Travis CI
  • Fix mail variables
  • Fix SEO helper, cache issue in media.
  • Add option to disable preview feature (Ex: \SlugHelper::disablePreview(Post::class))
  • Refactor code.

Botble 4.0


  • Upgraded to Laravel 6.0. Now this CMS requires PHP >=7.2 (

  • Refactor database to improve query performance.

  • slugs: renamed column reference to reference_type and using model class instead of screen name. Ex: reference_type is post now changed to Botble\Blog\Models\Post.

  • language_meta: renamed column lang_meta_content_id to reference_id and lang_meta_reference to reference_type. Using model class instead of screen name. Ex: reference_type is post now changed to Botble\Blog\Models\Post.

  • menu_nodes: renamed column related_id to reference_id and type to reference_type. Using model class instead of screen name. Ex: reference_type is post now changed to Botble\Blog\Models\Post.

  • meta_boxes: renamed column content_id to reference_id and reference to reference. Using model class instead of screen name. Ex: reference_type is post now changed to Botble\Blog\Models\Post.

  • Update meta boxes helpers: Remove screen name in function. (get_meta_data(), get_meta(), save_meta_data(), delete_meta_data()) Ex:

    // Before
    function get_meta_data($object->id, $key, $screen, $single = false, $select = ['meta_value'])
// Now
function get_meta_data($object, $key, $single = false, $select = ['meta_value'])
  • All forms now require to setup model. Ex: platform/plugins/blog/src/Forms/PostForm.php:54
    $this->setupModel(new Post);

Botble 3.6.1


  • Fix bug delete widget.
  • Fix bug search users.
  • Refactor code.
  • Improve performance.

Botble 3.6


  • Fix bug repeater field with image, file in custom fields plugin.
  • Move plugin management into /packages. Now it's a optional feature, you can remove botble/plugin-management and run composer update to remove plugin feature.
  • Update composer.json. Add package wikimedia/composer-merge-plugin.
  • Add command to regenerate image sizes: php artisan cms:media:thumnail:generate.
  • Add default theme options: site title, SEO meta tags.
  • Add search box on tables.
  • Update translations.
  • Optimize performance & refactor code.

Botble 3.5.1


  • Hotfix delete language.

Add this line into platform/plugins/language/resources/views/index.blade.php:191


Botble 3.5


  • Restructure asset files.
  • Fix security issue in upload user's avatar.
  • Change default value for status column to published instead of publish.
  • Create dev-tool package.
  • Change binding type for repositories from singleton to bind.
  • Remove @author in comment docs.
  • Fix language issue.
  • Fix dashboard widgets.
  • Allow to create user without role.
  • Refactor, clean migrations.

Botble 3.4


  • Upgraded to the latest Laravel version 5.8

  • Change folder structure: core, plugins and public/themes are now located in /platform folder.

  • Contact plugin: Allow to reply directly from admin panel.

  • Improve admin UI.

  • Move some plugins to packages. Now we have a new folder is /platform/packages (it is the place for required plugins).

  • Theme's directory is now located in /platform/themes/your-theme so it can't access directly anymore. After make change on theme's assets, you will need to run command php artisan cms:theme:assets:publish your-theme to copy assets to /public/themes/your-themes.

  • Made some change on assets module.

    • Refactor some methods.

      • addJavascript => addScripts
      • removeJavascript => removeScripts
      • getJavascript => getScripts
      • addStylesheets => addStyles
      • removeStylesheets => removeStyles
      • getStylesheets => getStyles
      • addStylesheetsDirectly => addStylesDirectly
      • addJavascriptDirectly => addScriptsDirectly
    • Change some config keys:

      • javascript => scripts
      • stylesheets => styles
  • Change folder to upload to storage/uploads, you need to run command php artisan storage:link to create symlink.

  • Change event to listen when adding admin menu.

Change \Botble\Base\Events\SessionStarted::class to \Illuminate\Routing\Events\RouteMatched::class


\Event::listen(\Illuminate\Routing\Events\RouteMatched::class, function () {
        'id' => 'cms-plugins-<your-plugin>', // key of menu, it should unique
        'priority' => 5,
        'parent_id' => null,
        'name' => __('Your plugin name'), // menu name, if you don't need translation, you can use the name in plain text
        'icon' => 'fa fa-camera',
        'url' => route('<plugins>.list'), // route to your plugin list.
        'permissions' => ['<plugins>.list'], // permission should same with route name, you can see that flag in Plugin.php

Botble 3.3.1


  • Hotfix: Disabled installation Botble CMS from UI because of security issues.

Botble 3.3


Botble 3.2.1


  • Hotfix bulk actions and language column

Botble 3.2


  • Fix bug UI & update admin UI
  • Add Chinese language
  • Refactor code & optimize queries
  • Update vendor packages

Botble 3.1


  • Support multi-language for theme options & widgets
  • Fix bug add super users
  • Upgrade table system & add filter tables
  • Support change language on the login page
  • Fix bug adding admin locale
  • Fix bug create plugin by command

Botble 3.0.2


  • Hotfix bug cannot create new custom field

Botble 3.0.1


  • Fix bug cropping image size.
  • Fix preview image in media management
  • Move API clients to settings.
  • Update UI for member frontend.
  • Update UI in admin panel.

Botble 3.0


  • Upgrade to Laravel 5.6 (change PHP required version to >=7.1.3)
  • Add Passport support
  • Refactor plugin system
  • Refactor ACL system
  • Fix bug member login and forgot password.
  • Update UI
  • Update some vendor packages

Botble 2.6


  • Fix member reset password bug.
  • Fix to change status after creating a new plugin.
  • Auto register plugin menu to admin dashboard after creating new plugin.
  • Update vendor packages.
  • Fix coding standard.

Botble 2.5


  • Update media module. Support Amazon S3 and allowing to upload video/mp4, support preview .mp4 video on admin panel.
  • Allowing to add more extensions. Just need to add to .env file.
  • Fix admin menu with permissions.
  • Fix some UI bugs.
  • Add cache management. Now we can clear cache from admin panel.
  • Upgrade custom field: Fix bugs, refactor code & adding import/export functions.

Botble 2.4.2


- Refactor plugin language to make it easier to integrate with new plugin (check FAQ for more detail).
- Fix bug when deleting default user `botble`.
- Redirect back to previous page after login
- Update default database.
- Refactor slug plugin.

Botble 2.4.1

- Fix bug change profile image
- Refactor plugin language & gallery
- Move member to plugin
- Update default database

Botble 2.4

- Upgrade to latest Laravel version 5.5. In this version, it's required PHP >= 7.0
- Separate Admin users and members.
- Update editor: allows multiple rich editor in a page, switch between text editor & rich editor.
- Fix UI: dashboard widgets, plugins.

{warning} This a big update with Laravel framework, it's core update so to upgrade from version 2.3, you should copy your themes and plugins to version 2.4 and use new database from /database.sql.

Botble 2.3.1

- Fix create a Category.
- Move analytics JSON config file to storage path.
- Move repositories, criteria to support module.
- Optimize media module.

Botble 2.3

- Apply new media management. There is many change on media on this version so the document for Media will be update later.
- Add shortcode button above editor to easy add shortcode.
- Allow switch between Ckeditor and Tinymce.
- Fix bug when create new role.
- Fix bug activate/deactivate user.
- Add create user in admin area, now we have 2 options: create user and invite user.
- Remove function get_file_by_size(). Now you can use get_image_url($post->image, 'thumb') instead of get_file_by_size.
- Add front site users area.

Botble 2.2.1

- Add post format (Default, gallery, video...)
- Fix bug in plugin language when default language is not set.
- Change route name of post, page, category in front site from "public.view" to "public.single.detail"
- Fix counter in Dashboard.
- Refactor admin breadcrumb.
- Set page title for each page in admin area.
- Add new demo theme
- Refactor show category list, theme list...
- Remove admin bar config in theme

Botble 2.2

- Easier theme breadcrumbs. Now you can use Theme::breadcrumb()->add('label', 'http://...')->add('label2', 'http:...');
- Fix invite user
- Fix reset password
- Update email template and send mail function.
Now you can send mail by: `EmailHandler::send('Hello there', 'Test email', ['name' => 'Sang Nguyen', 'to' => '[email protected]']);`
- Remove laroute package.
Please remove LarouteServiceProvider on /config/app.php and laroute package on composer.json.

Botble 2.1

- Upgrade to Laravel 5.4.
- Upgrade custom field plugin
- Refactor assets structure
- Fix error when installing.
- Fix analytics plugin after installation.

Botble 2.0


- Fix Media upload error
- Please see image attachment in this issue to update your code.


- Fix installation script.


Release Botble version 2.0

Botble 1.0


 - Fix folders in media is not accessible: To update, you just need update two files:
      + /resources/views/files/partials/folder-row.blade.php
      + /resources/views/files/partials/uplevel.blade.php
 - Fix Menu management: 
    Run "composer update" to update menu package or replace /vendor/botble/menu folder.


- Fix menu module (just run "composer update" to update menu module)
- Fix media uploads:
    Replace botbe/repositories/feature, 
    and app/http/endpoints/feature, media.js in assets.


- Upgrade to Laravel 5.3


- Update routes and media


- Add social login (login to admin page via facebook, github, google...


- Add contact form support, fix some small bugs.


- Fix dashboard widget, custom field and media management.


- Initial release Version 1.0