Skip to content

Commit

Permalink
Front end toolbar details (#30)
Browse files Browse the repository at this point in the history
* Front-end Toolbar article in Basic Concept with link to further documentation.
* Front end toolbar page setup
* Added User Info and Change Set link
* First two option of the front-end toolbar documented.
* Added Inline Edit documentation.
* Front-end toolbar: Add and Version History added.
* Added Preview part.
* Added Change Sets

---------

Co-authored-by: Guust Nieuwenhuis <[email protected]>
  • Loading branch information
jeroenweareorangeeu and guustnieuwenhuis committed Aug 25, 2023
1 parent 381a577 commit 865f649
Show file tree
Hide file tree
Showing 20 changed files with 99 additions and 4 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ This is a dropdown with different options:
## Add
A popup now opens with new Content Types to choose from to add to Masa CMS.
## Version History
Redirects to the Masa CSM Admin to show the Version History of this Page.
Redirects to the Masa CMS Admin to show the Version History of this Page.

## Multi-Device Preview
A popup opens in which you preview the Page on different devices / screen resolutions.
Expand Down
101 changes: 98 additions & 3 deletions 02_content/01_layout-manager/01_front-end-toolbar.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,106 @@ permalink: /content/layout-manager/front-end-toolbar/

# Front-end toolbar

The Front-end Toolbar is a useful tool for inline editing the content of your page. In the following sections the different features are described.
The Front-end Toolbar is a useful tool for inline editing the content of your page.
It's displayed on top of the website when you are logged into the Masa CMS Admin.
In the following sections the different features are described from left to right.

## Switch visibility of the Front-end toolbar
The first option is the Masa CMS Logo in the Front-end Toolbar. By clicking on the logo you can switch between a full Front-end Toolbar and a small Masa CMS icon. This feature is convenient when you have content directly at the top of page of you website and want to view it.

1. Full toolbar:
![frontendtoolbarfull](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_full.png)

2. Icon:
![frontendtoolbaricon](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_icon.png)

## Published and Save
The second option is the 'Published' and 'Save' option.
The options switch depending on if you've made changes on the page or not.

When the page is not changed and you click on 'Published' a popup will open and show you publishing information of the page.
![frontendtoolbarpublishedmodal](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_published_modal.png)

When changes are made on the page the 'Published' option is changed to a 'Save' dropdown menu.
![frontendtoolbarsavemenu](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_save_menu.png)

This menu has the following options:

1. Publish: save the changes and publish them directly.
2. Save Draft: save the changes as a draft to edit and publish later.
3. Save to Change Set: save the changes to a Changeset for updating the site in bulk.
4. Cancel: all changes are discarded.

## Front-end editing
![frontendtoolbareditmenu](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_edit_menu.png)
This option is a dropdown menu with the following options:
### Inline Edit
If you click this option then you can inline edit the page.

#### Editable fields
The editable field will light up with a red fieldname above it:
![frontendtoolbarinlineedit](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_inline_edit_red.png)
You can edit this part of the page. When you are done editing click 'Done Editing' on the right of the page.
![frontendtoolbardoneediting](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_inline_done_editing.png)
After editing you also need to save your changes, either by publishing directly, saving to draft or saving to Change Set.

#### Display Regions
The Display Regions that are used in the template that is configured for this page will also light up in red borders:
![frontendtoolbardonedisplayregionseditred](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_display_regions_edit_red.png)
A menu on the right of the page opens up with all the Modules you can drag and drop into a Display Region.
![frontendtoolbardisplaymodules](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_display_modules.png)
After dropping a Module into a Display Region, you can change the order of the Modules in the Display Region by drag-and-dropping them.
When Modules are placed into a Display Region you can edit them by clicking the blue pencil icon.
A menu on the right of the page opens ups with all the configurable options for this Module.

Example for the Archive Navigation Module:
![frontendtoolbarmodulearchiveexample](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_module_archive_example.png)
Each Module has different configurable options; e.g. the Module 'Call to Action' has different options than the Module 'Image'.
After editing you also need to save your changes, either by publishing directly, saving to draft or saving to a Change Set.

### Full Edit
Redirects to the Masa CMS Admin to edit the page there.
### Delete
This will the delete the page and all it's content nested beneath it.
You need to confirm this action in a popup:
![frontendtoolbardeletepopup](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_delete_popup.png)

## Add
When you selecting this option a popup opens with the Content Types to add to the site.
![frontendtoolbaraddmenu](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_add_menu.png)
When selecting an item from the popup you are directed to the Masa CMS Admin where you can edit the new item.

## Version History
When selecting this option you are redirected to the Masa CMS Admin where you can view the Version History of the page:
![frontendtoolbarversionhistory](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_version_history.png)

## Permissions
Based on your permissions the Front-end Toolbar changes.
This can be because of Permissions, Approval Chains, etc.

## Multi-device preview
When you selecting this option a popup opens with the current page in a preview mode.
You can preview the page on different devices. These devices are Desktop, Tablet, Tablet Landscape, Phone, Phone Landscape.
![frontendtoolbarpreview](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_preview.png)
This way you can check how a page is displayed on different devices.

## Change Sets
These options are used for viewing changes that are in a Change Set.
Change Sets are helpfull for bulk updating the content of your website.
All changes to your content are put in one Change Set, which can be published all at once.

### Managing Change Sets
Change Sets themselves are managed in the Masa CMS Admin. In het left menu goto the second item 'Staging'.
![frontendtoolbaradminstaging](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_admin_staging.png)
An overview of all your Change Sets are shown.

## Media preview
### Adding changes to Change Sets
Changes are put into the Change Set by saving the changes to a Change set, rather than publishing them directly or saving them as draft.
![frontendtoolbarsavechangeset](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_save_change_set.png)

## Change sets
### View changes in Change Set
By selecting a Change Set in the dropdown you can see the proposed changes applied to the content of the current page.
![frontendtoolbarchangesets](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_changesets.png)
The second menu item 'Assignments' shows a dropdown of all the changed content items in the current Change Set.
![frontendtoolbarassignments](/assets/02_content/01_layout-manager/01_front-end-toolbar/front-end-toolbar_assignments.png)
The third item is an indicator to show if the current page is already in the current Change Set or not.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 865f649

Please sign in to comment.