001101 / humhub-modules-custom-pages Goto Github PK

The custom pages modules allows the creation of customized pages and snippets as well as on space global level.

Depending on content type and target the following content types are available:

• MarkDown (HumHub Markdown Richtext based page)
• Link (External link)
• Iframe
• Template
• Html (Only available for global pages for security reasons)
• PHP (requires further activation under Administration -> Custom Pages -> Settings)

By default the module supports the following targets for global pages:

• Top Navigation
• User Account Menu (Account Settings)
• Directory Menu
• No Specific target (Direct link)

and global Snippets:

• Dashboard
• Directory

On space level the following page targets are supported by default:

• Space Navigation

and snippets:

• Stream Sidebar

Since v.1.0 external modules can provide own targets through the CustomPagesService.

Module website: https://github.com/humhub/humhub-modules-custom-pages
Author: luke, buddh4
Author website: humhub.org

https://github.com/humhub/humhub-modules-custom-pages/commits/master

https://github.com/humhub/humhub-modules-custom-pages/issues

Global pages and snippets can be maintained by administrators in Administration -> Custom Pages -> Overview.

Space pages and snippets require additional module installation on space level and can be maintained by space administrators in Space Settings Dropdown -> Custom Pages.

After selecting a target for your new page as for example the Top Navigation, you have to select a content type. On space level the available content types are limited for security reasons.

Most content types provide the following setting which may vary between different targets:

The custom pages module provides a simple template mechanism based on twig. Templates can be maintained under Administration -> Templates.

Note: In order to use template based pages or snippets on space level, you'll have to allow the layout for spaces within the general settings of the template.

When creating a new template based page or snippet, you have to select a layout template which is used as the base layout of your page. Usually a layout will consist of static elements as for example a headline, subheadline and container elements.

You can add the following static elements to your layout:

A very simple layout could look like the following:

<style>
 // Some additional styling 
<style>

<div class="row">
    <div class="col-md-12">
        <div class="panel panel-default">
            <div class="panel-heading">
                {{ headline }}
            </div>
            <div class="panel-body">
                <div class="abstract">
                    {{ abstract }}
                </div>
                <div class="abstract">
                    {{ content }}
                </div>
            </div>
        </div>
    </div>
</div>

With a simple text element as headline, a HumHub Richtext as abstract and a container element which allows multiple container items.

A container element can contain one or multiple container items. Container items themselves are based on templates managed under Administration -> Tempaltes -> Container. A container element can either act as container of inline or block elements or just allow a single element. Furthermore a container element can restrict the allowed types of container items.

The following example shows a simple quotation container element with two text elements text and info:

<blockquote>
    {{ text }}
</blockquote>
<span>{{ info }}</span>

Another container example with a figure and floating text based upon a image image element and figcaption text element:

<figure class="pull-left">
    {{ image }}
</figure>
<figcaption>{{ figcaption }}</figcaption>

<p> {{ text }}</p>