Plone Mosaic Site Builder and Site Layout
Plone Mosaic is a site builder and layout solution for Plone.
Read this introduction and the package documentation for more details how to use this package.
Mosaic Editor editor is a visual editor for pages rendered using Blocks. It relies on a grid system to place tiles onto a page in an intuitive, WYSIWYG, drag-and-drop manner. Using Mosaic Editor, it is easy to compose pages with complex, balanced and visually appealing layouts.
Currently, the Mosaic Editor is activated, when any content with Mosaic layout view active is being edited. (Mosaic layout is available for any content with Layout support behavior enabled.)
Blocks is a rendering algorithm based on HTML markup conventions. A page managed by Mosaic Editor is stored as a simple HTML document. It is representing the actual content of that page as a standalone, publishable resource devoid of any site layout content (e.g. global navigation elements). This is referred to as content layout.
Tiles represent the dynamic portions of a page. At its most basic level, a tile is simply an HTML document with a publishable URL.
In practice, tiles are usually implemented as browser views deriving from the Tile base class and registered with the <plone:tile /> ZCML directive. This allows tiles to have some basic metadata and automatically generated edit forms for any configurable aspects, which Mosaic will expose to users. See plone.tiles for examples.
When work with tiles in Mosaic Editor, there are three types of tiles:
- Text tiles
- Static HTML markup (WYSIWYG-edited text) placed into the content or site layout. Strictly speaking, text tiles are not tiles in that they do not involve any tile fetching or merging - instead they are stored as part of the page or site layout. To the user, however, a text tile can be moved around and managed like any other.
- Field tiles
- Render the value of a metadata field such as the title or description. The values of field tiles may be edited in-place in the page, but the value is stored in the underlying field and can be indexed in the catalog, used for navigation and so on. In practice, a field tile is an instance of the special tile plone.app.standardtiles.fields with the field name passed as a parameter.
- App tiles
- Any other type of dynamic tile. Examples may include a folder listing, a media player, a poll or pretty much anything else you can think of.
Advanced Editor usage
- Advanced mode
- If you press the “alt” key you will be shown the layout structure, labels for your tiles and css classes for rows.
- Custom classes on rows
- Also in the advanced mode, you’re able to add custom classes on rows by double clicking the displayed row class.
- In order to nest columns inside a cell, drag a tile, then press the “ctrl” key and drop the tile close to an existing one, either before or after it, in accordance to the shown insert marker.
- Fluid rows
- For fluid (full width) rows select any tile in the row and choose “Fluid” from the “Format” menu. Fluid row styles only make sense on pages without portlets. In Plone 5.1.3 we can check that automatically (with plone.app.layout 2.8.0) and those styles are only active if no portlet columns are shown.
Plone Mosaic is installed by building a Plone site with package plone.app.mosaic and activating its Plone Mosaic add-on.
The dependencies are already version pinned in Plones ecosystem.
However, if a newer version of mosaic is needed, the good known set for the version can be found at Github, Mosaic Code repository, in the file versions.cfg.
After the add-on activation, the new content layout and editor support can be enabled for any content type by enabling behaviors Layout support and Drafting support.
Plone Mosaic is considered to be in early production phase. All feature are working and Mosaic is used in production.
Translations are still missing.
Not all the features of Plone Mosaic have yet easily accessible UI (e.g. layouts can be created into portal_resources and bound to content types as named views only through Zope Management Interface, ZMI).
Plone 5 version of Plone Mosaic is available for development using plips/plip-mosaic.cfg at Plone 5 coredev-buildout.
Plone 4 version of Plone Mosaic can be developed by cloning the product directly.
Clone and build:
$ git clone https://github.com/plone/plone.app.mosaic $ cd plone.app.mosaic $ python bootstrap.py # clean python 2.7 virtualenv recommended $ bin/buildout
- open a browser at http://localhost:55001/plone/++add++Document
- login as admin with password secret
- save the new page
- from the Display-menu, select the new entry Mosaic layout
- click Edit to see the new Mosaic Editor
Alternatively you can also use bin/instance fg.
$ make install $ make clean all mode=release
The bundle can also be built with source maps and watched for changes with:
$ npm install $ make clean all watch
Webpack based frontent development
Plone Mosaic can be developed with Webpack running:
$ make watch_theme
or starting the instances either manually or with make watch_instance and starting the Webpack development server with:
$ make watch_webpack
Once you have activated theme called Plone Mosaic, the editor will be reloaded and rebuilt by Webpack development server after each filesystem change.
To script screenshots into the Sphinx documentation, use the development buildout:
$ git clone https://github.com/plone/plone.app.mosaic $ cd plone.app.mosaic $ python bootstrap.py # clean python 2.7 virtualenv recommended $ bin/buildout -c develop.cfg
To speed up your iterations, before compiling the docs, start the robot server with:
$ bin/robot-server plone.app.mosaic.testing.PLONE_APP_MOSAIC_ROBOT -v
With robot-server running, you can re-build the docs’ screenshots relatively fast with:
$ bin/robot-sphinx docs html
Or simply run the embedded screenshots as robot tests from a single document with:
$ bin/robot docs/getting-started.rst
or with phantomjs:
$ bin/robot -v BROWSER:phantomjs docs/getting-started.rst
and open ./report.html to view the test report.
Just add Debug keyword anywhere to pause the robot in the middle of the screenshot script and drop you into a Robot Framework REPL.
- Fluid row styles only make sense on pages without portlets. In Plone 5.1.3 we can check that automatically (with plone.app.layout 2.8.0) and those styles are only active if no portlet columns are shown. [agitator]
- Add functionality for fluid (full width) rows. [agitator, davilima6]
- Add documentation for advanced editor features. [agitator, davilima6]
- Image in “Existing-Content” Tile scaled width only, height was kept and aspect-ratio broke. Fixes https://github.com/plone/plone.app.standardtiles/issues/83. [jensens]
- Hide dependencies - like blocks and tiles - of Mosaic from appearing at Plone site setup. This reduces confusion and removes clutter from the setup screen. [jensens]
- Transform: Acquire a safe context or the portal object. In cases of a 404 page, the context is a browser view. [thet]
- Imports are Python3 compatible [b4oshany]
- Cleanup old code that would initialize TinyMCE several times for richtext tiles Fixes issue 407. [frapell]
WARNING: Upgrading from plone.app.mosaic 1.x will make pages with mosaic layout look empty until plone.app.blocks has been upgraded (upgrade steps been run). After upgrade, you may need to manually tweak Plone registry to only display the desired tiles.
- Fix regression in 2.0.rc7 where removal of dead code was not completed resulting in a runtime error [datakurre]
- Add simple descriptions for all the tiles listed in the docs. [cguardia]
- Allow to nest columns inside a cell [frapell]
- Allow to include custom CSS on rows [frapell]
- Fix issue where default rich text tiles had context menu from legacy HTML table tile [datakurre]
- Fix issue where TinyMCE was broken in properties overlay [datakurre]
- Fix issue where title field value was not set on some IE version [datakurre]
- Fix issue where block elements with display ‘flex’ were not blurred [datakurre]
- Add support for optiona permission-key in content layout manifests [datakurre]
- Fix grid and row styles for anonymous [agitator]
- Fix issue where global TinyMCE setting for paste_as_text was not respected [datakurre]
- Fix issue where Mosaic Editor was activated on babel edit view [datakurre]
- Fix issue where Mosaic transforms did fire for ESI requests for ESI tile helper views [datakurre]
- Fix issue where multiple tile configurations from the same page were being autosaved at the same time causing write conflict errors [datakurre]
- Fix issue where configured text tile content was not removed from the server when tile was deleted [datakurre]
- Remove unneeded unittest2 imports [tomgross]
- Show layouts description in Mosaic Select Layout overlay [annegilles]
- Disable non-functional table of contents tile by default [datakurre]
- Fix issue where toolbar menus were initially hidden on custom layout [datakurre]
- Fix issue where TinyMCE format menu was not visible [datakurre]
- Fix issue where default layouts did not work properly, because they were registered as unicode strings when encoded ASCII strings were required [datakurre]
- Fix to disable layout editor when edit form has a status message (which is usually a validation error message) as workaround for editor not being able to display validation errors [datakurre]
WARNING: Migration from 1.0.0 to 2.0.0 may still have unsolved issues.
- In the BodyClass transform, retrieve the content layout path from ILayoutAware provided method which also considers default paths registered in the registry. Fixes no layout classes added to the body tag with default content layouts for types. [thet]
- Show layouts description in Mosaic Select Layout overlay [annegilles]
- Include source code button into TinyMCE toolbar by default [datakurre]
- plone_view/mark_view was deprecated and removed. Use plone_layout/mark_view instead. [thet]
- Fix issue where incomplete mosaic-grid bundle definition broke Plone bundle merge [datakurre]
- Enhance documentation [agitator, AnneGilles, krissik, staeff]
- Fixes problems introduces with grid responsive styles [agitator]
- Fix issue where layout menu was misplaced in Mosaic toolbar [datakurre]
WARNING: Migration from 1.0.0 to 2.0.0 may still unsolved have issues.
- Drop compatibility with Plone 4.3. For Plone 4.3 support, please use plone.app.mosaic < 2.0 [datakurre, jensens]
- Depend on adapterized plone.app.blocks >= 4.0.0 [jensens]
- Depend on plone.app.contenttypes (for GS install profile) [jensens]
- Move to using plone.app.standardtiles.html instead of the deprecated plone.app.standardtiles.rawhtml [vangheem]
- No longer use special HTML tiles that do not work in reusable layouts. These tiles are now all deprecated: table, numbers, bullets, text, subheading, heading [vangheem]
- Remove use image and attachment tiles as they are now deprecated [vangheem]
- Move custom layout from ‘content’ to ‘customContentLayout’ attribute [datakurre]
- Replace Deco-grid styles with Bootstrap mixins form mixins.grid.plone.less. Allows to use override grid system using standard mosaic class names. Main purpose is to unify the edit and view of your layout (fixes https://github.com/plone/plone.app.mosaic/issues/231). [agitator]
- Customize add form for types that have ILayoutAware enabled so that it just presents a title/description field [vangheem]
- Provide outline mode to be able to inspect rows and tiles [datakurre]
- Add preview button (disabled by default) for previewing currently edited layout [datakurre]
- Add a new raw embed tile [agitator]
- Saving a layout will now save default values for html tiles on the reusable layout. [vangheem]
- Provide better use of permissions in UI and enforcements on the server [vangheem]
- Enhance layout selector styles [vangheem]
- Hide plone toolbar when mosaic editor is active [vangheem]
- Move tile remove button onto tile instead of in toolbar [vangheem]
- Rename “Close” to “Done” on properties form. [vangheem]
- Add sitelayouts-meta.zcml, which allows enabling site layouts in buildout with zcml = plone.app.mosaic-meta:sitelayouts-meta.zcml [datakurre]
- Handle missing tiles and tile configuration with layout editor where it doesn’t destroy user’s ability to still edit the layout/tiles. [vangheem]
- Fix bug when tinymce editor would no longer work when dragging one rich text tile around another rich text tile. [vangheem]
- Fixes TinyMCE focus issues, disables row merging [vangheem]
- Fix TinyMCE Insert Image search results to have fixed maximum height to prevent it from flowing over viewport [datakurre]
- Fix fieldset tabbing not working after user edits field tiles [vangheem]
- Fix pasting into title, description fields [vangheem]
- Use POST to render tiles through the editor so default query parameters provided in url can be utilized with latest plone.tiles [vangheem]
- Fix problem where layouts could be saved without a name [vangheem]
- Fix table context menu overlapping modals [vangheem]
- Fix default layout image not showing properly [vangheem]
- Fix modal to be structured like other plone modals [vangheem]
- Fix to not set own overhead space of edit modal, the default should apply [jensens]
- Fix reference to default layout preview image [vangheem]
- Fix issue where pattern settings are not applied to the body tag for mosaic layouts [jensens]
- Fix issue where plone_pattern_setting view lookup ran into empty (now renders all) [jensens]
- Move list of valid layout view names for LayoutWidget in a module variable, so it can be extended on demand [jensens]
- Remove superfluos empty testing gs profile and its zcml [jensens]
- Log warning if plone_pattern_settings view was not found [jensens]
- Fix robot tests in docs to no run into timing traps [jensens, gforcada]
- Use buildout.coredev version pins [gforcada]
- Update testing infrastructure [gforcada]
- Make layouts HTML valid [gforcada]
- Add Webpack based frontend development flow [datakurre]
- Nothing changed.
- Fixed TypeError during editing when no layout resource directory was found. [maurits]
- Allow users to save layouts they are creating [vangheem]
- If only one layout is available, auto-select it. [vangheem]
- Be able to show/hide content layouts. [vangheem]
- Add Mosaic layout into available views views when layout behavior is enabled and remove the view when layout behavior is disabled from a portal ype [datakurre]
- Ability to limit maximum amount of Mosaic columns by setting data-max-columns attribute on data-panel -element (default: 4). [neilferreira]
- Align rich text editor right if the tile is more on the right side of the page [vangheem]
- Do not remove data-pat-tinymce body attribute as this is not necessary with how tinymce is initialized anymore [vangheem]
- Fix use of rawhtml text tile [vangheem]
- Fix case where you could get an error on save because mosaic could not figure out the tile type correctly [vangheem]
- Do not allow hitting enter for editing non-rich text fields [vangheem]
- Disable clicking links of content inside tiles while in edit mode [vangheem]
- Fix TinyMCE widget in add-form which was broken due to a change how the settings are stored in Plone 5 vs 4. BBB compatible. [jensens]
- Fix tinymce toolbar scrolling out of view with large rich text tiles. TinyMCE toolbar will now being sticky as the user scrolls down. [vangheem]
- Fix do not add _layout multiple times to tile data [vangheem]
- Fix issue where spurious was getting saved to description [vangheem]
- Issue when registry configuration parsing would throw an error [vangheem]
- Fix issue where you would end up saving non-resolveuid urls to rawhtml tiles and also prevent write conflicts when the editor sends out multiple edits at the same time [vangheem]
- Fix to only show drag handlers if customizing layout [vangheem]
- fix issue where you would no longer be able to edit a rich text area after you clear the whole area out [vangheem]
- Fix weird Firefox bug with TinyMCE that prevented data from being saved. [vangheem]
- Fix properties overlay to be scrollable. [vangheem]
- Fix issue where tile field wouldn’t get saved back to form with some refactoring. [vangheem]
- Fix issue where first fieldset would not show on properties modal. [vangheem]
- Add ploneimage action for richtext tiles’ toolbar [datakurre]
- Add transforms to set ‘layout-‘ with active content layout name or ‘layout-custom’ into body class [datakurre]
- Fix issue where mosaic-grid was enabled even a default grid system was set [datakurre]
- Fix issue where Plone body class was added twice [datakurre]
- Fix issue where contentLayout field was shown in tile menu [datakurre]
- Pin plone.app.standardtiles >= 1.0b3 [datakurre]
- Change layout behavior default view from view to layout_view [datakurre]
- Change to enable Mosaic layout noly for Document, Event, Folder and News Item by default [datakurre]
- Change text formatting actions from top toolbar to inline TinyMCE toolbars [datakurre]
- Change remove tile icon from inline close icons to top toolbar button [datakurre]
- Change BS3 as default grid system on Plone 5 [vangheem]
- Change site layouts be disabled unless mosaic-sitelayouts feature is set [datakurre]
- Change displayemenu support be disabled unless mosaic-layoutmenu feature is set [datakurre]
- Change Custom layout menu item to be called Mosaic layout [datakurre]
- Change install to no longer to make Mosaic layout the default by default [datakurre]
- Add layout editor control panel for Plone 5 [vangheem]
- Add link and unlink actions [datakurre]
- Add table tile [datakurre]
- Remove grid system from example layouts (to use configured default grid) [vangheem]
- Remove previously provided TTW content layout examples [datakurre]
- Fixed to work with (and require) plone.app.blocks >= 3.0.0 [vangheem]
- Fix GenericSetup profile registration (removed “for”) [agitator]
- Fix issue where title field tile and content tile being use on same page would cause weird issues with saving title values [vangheem]
- Fix situation where layout editor broke with broken or missing tiles [vangheem]
- Fix issue where check could not add tile with requried selection field [datakurre]
- Add “Bootstrap 3 Demo” example site layouts for Plone 5 [datakurre]
- Add support for plone.app.blocks’ generic data grid transform [datakurre]
- Change the default site layouts in Plone 5 to use 12 column deco grids [datakurre]
- Fix various site layout support related issues [datakurre]
- Upgrade to plone.app.drafts >= 1.0b3 and plone.app.blocks >= 2.1.2 [datakurre]
- Add ‘Center tile content’ tile style to allow e.g. centering of image tiles [datakurre]
- Add site and page layout fields to be available on properties overlay [datakurre]
- Add HTML tag language transform to set correct langauge for HTML site layouts [datakurre]
- Add HTML body tag class transform to set body class for HTML site layouts [datakurre]
- Add HTTP headers transform to ensure that the response headers normally set by plone.httpheaders viewlet manager are also set for HTML site layouts [datakurre]
- Update example site and content layouts [datakurre]
- Fix to only cache site layout when it’s not the default main_template [datakurre]
- Upgrade to plone.app.drafts >= 1.0b2 and plone.app.standardtiles >= 1.0b1 [datakurre]
- First technology preview release.