Questions & Answers

How do I add an item to my toolbar?

Go to your dashboard (or open up the Dashboard menu on the right). Click on “System & Settings” and navigate to “Toolbar Designer”. Within this page you can either click the “Add Item” button in the top right corner or click “Add Item” under the Position Left/Position Right section (this will set the position within the form already). You’ll be taken to a form where you can fill in the values as you please.

How do I switch from Position Left to Position Right?

Just edit an item by clicking the pencil/edit button after an item, and change the value below “Position”. It will be added on the bottom of the position, and you can rearrange this in the overview if you don’t want it at the bottom.

I have multiple items within a position (Right/Left), how do I rearrange them?

When navigated to “System & Settings” –  “Toolbar Designer”, you can use the “move” icon on the right. Click and drag to the position you want. You can’t drag this into another position (from left to right or vice versa), you will have to edit this by clicking the edit button.

Active, why is this option there?

This option gives you the ability to temporarily de-activate an item in your toolbar. Let’s say you have an external URL to some site with information about Halloween. You do not want to show this throughout the whole year. There are numerous examples I can think of, if you don’t want to de-activate, simply leave this box checked.

I can choose from a couple of presets, but a preset I had in mind is not in it. What to do now?

You can drop a message if this preset is a page/location part of the core. This can then be implemented into a future version of the Add-On. If it’s part of a different Add-On, the developer of that specific Add-On can code in presets. A typical example of how to do that looks like this (a function, in the controller.php file of an Add-On):

[code]

  public function getToolbarDesignerPresets()

    {

        return array(

            '/dashboard/blocks/block_designer' => array(

                'title'             => t('Block Designer'),

                'controller_handle' => 'item_default',

                'pkg_handle'        => 'toolbar_designer',

                'cPath'             => '/dashboard/blocks/block_designer',

            ),

        );

    }

[/code]

If you’re using Block Designer (https://www.concrete5.org/marketplace/addons/block-designer), you should have this as a preset too. That’s the example code above.

Controller Handle.. what does this do (under “Custom”  type)?

The controller handle is actually a file. This file will handle whether to show the item in the toolbar or not. You can make as many of these as you’d like (they are to be found within an Add-On). Learn something about making controllers here: https://www.concrete5.org/documentation/how-tos/developers/adding-a-menu-item-5.7/

“Item Default”, the controller handle that ships with this Add-On, simply always shows the item in the toolbar. If you need more advanced checking, you can make controllers as you please. It’s required to select one and Item Default is preselected upon creating an item.

I want an item that links to an external site, can I do that?

Yes, select “Custom” as Type and enter your URL into the “Location” field. Please start with www. Or http:// though, so the system knows it’s actually an external URL. Everything else will be internal URL’s.

I’ve seen more icons for FontAwesome, but they aren’t in the dropdown. Why is that?

Concrete5 uses version 4.2 of FontAwesome (in version 5.7.5.2 and lower). This version of FontAwesome hasn’t got all icons in it. When Concrete5 updates this version, you can select them. So for now, you’ll have to select one of the available ones.

I did not select an icon, but still an “arrow” icon is being shown in the toolbar?

This is default Concrete5 behaviour. There has to be an icon, otherwise you click “nothing”. Concrete5 defaulted the icon to this right/share arrow. Better select an icon if you don’t want that (although an icon is not required using this Add-On).

I’ve got too many items, that on my mobile they stack below each other…

There’s a section “Hide for specific devices” when you edit a toolbar item. You can choose to hide for extra small, medium, small and larger devices. These are handles using Bootstrap classes. If you frontend theme does not use Bootstrap, you will have to code in some CSS to get this working.

When you’ve hidden a specific item for the current device, you will still be able to see the example in the overview. It will be hidden though in the toolbar, as you configured. This way you can always test the end result.

There’s a label field, but I don’t see that this is being used?

This label field is only shown when the “Enable Toolbar Titles” option is checked. This is an option under “System & Settings – “Basics” – “Accessibility” (or /index.php/dashboard/system/basics/accessibility). You can choose to leave this blank, so only the icon will show when this option is checked.

And what does the “Title” field do?

That’s being used when you hover an item in the toolbar. It literally add the “title” attribute to the anchor element. When you put your cursor on the item and wait for half a second, your browser will show you a little bar on this item with this title in it.

I want this module to be in my language too! What do I have to do?

This module ships with a messages.po file. If you’re not really familiar with how to find this, I can send you this file. Within this file you will see language lines in English with the translation below it. There are online PO file editors too, which are really simple (https://localise.biz/free/poeditor). If you send me your translated .po file back, I will implement it in the next version. I will do the conversion to .mo myself, so you needn’t to worry about that! .mo files are the files Concrete5 will be using.

This Add-On ships with the English and Dutch language by default.