DOCUMENTATION Jahia 6.5 Content Composites

Transcription

DOCUMENTATION
Jahia 6.5 Content Composites
Jahia’s next-generation, open source CMS stems from a widely
acknowledged vision of enterprise application convergence – web,
document, search, social and portal – unified by the simplicity of web
content management.
Jahia Solutions Group SA
9 route des Jeunes,
CH-1227 Les acacias
Geneva, Switzerland
http://www.jahia.com
Summary
Content Composites .......................................................................................................................................... 4
1
2
Definitions................................................................................................................................................... 4
1.1
Structure .............................................................................................................................................. 5
1.2
Categories ............................................................................................................................................ 5
Editorial Composites ................................................................................................................................... 6
2.1
Article ................................................................................................................................................... 6
2.2
Banner.................................................................................................................................................. 6
2.3
Big Text ................................................................................................................................................ 7
2.4
Contact ................................................................................................................................................. 7
2.5
External Link......................................................................................................................................... 8
2.6
File List ................................................................................................................................................. 8
2.7
Flash ..................................................................................................................................................... 8
2.8
Image ................................................................................................................................................... 9
2.9
Main Content ....................................................................................................................................... 9
2.10 News .................................................................................................................................................. 10
2.11 Teaser................................................................................................................................................. 10
2.12 Text .................................................................................................................................................... 11
2.13 Tree .................................................................................................................................................... 11
2.14 Event .................................................................................................................................................. 11
2.15 FAQ .................................................................................................................................................... 12
2.16 Job ...................................................................................................................................................... 12
2.17 Location ............................................................................................................................................. 13
2.18 People ................................................................................................................................................ 13
2.19 Press ................................................................................................................................................... 14
2.20 Publication ......................................................................................................................................... 14
2.21 Tasks................................................................................................................................................... 15
2.22 Static HTML ........................................................................................................................................ 15
2.23 Frame ................................................................................................................................................. 15
© 2002 – 2011 Jahia Solutions Group SA
Page 2 / 26
2.24 Video .................................................................................................................................................. 16
3
Functional Composites ............................................................................................................................. 17
3.1
Author Display ................................................................................................................................... 17
3.2
Back To Parent Page .......................................................................................................................... 17
3.3
Bookmarks ......................................................................................................................................... 17
3.4
BreadCrumb ....................................................................................................................................... 18
3.5
Calendar ............................................................................................................................................. 18
3.6
CSS Page ............................................................................................................................................. 18
3.7
Current User ...................................................................................................................................... 19
3.8
Facet................................................................................................................................................... 20
3.9
Form Builder ...................................................................................................................................... 20
3.10 Language Switcher ............................................................................................................................. 20
3.11 Latest ................................................................................................................................................. 21
3.12 Login Form ......................................................................................................................................... 21
3.13 Navigation Menu ............................................................................................................................... 21
3.14 Page Tagging ...................................................................................................................................... 22
3.15 Page Title ........................................................................................................................................... 22
3.16 Poll ..................................................................................................................................................... 22
3.17 Portlet ................................................................................................................................................ 22
3.18 Query ................................................................................................................................................. 23
3.19 Rating ................................................................................................................................................. 23
3.20 RSS ..................................................................................................................................................... 23
3.21 Search ................................................................................................................................................ 23
3.22 Shortcuts ............................................................................................................................................ 24
3.23 Twitter................................................................................................................................................ 24
3.24 Top Stories ......................................................................................................................................... 24
3.25 Sitemap .............................................................................................................................................. 25
3.26 User Registration ............................................................................................................................... 25
Page 3 / 26
Content Composites
1 Definitions
Module: a module is a folder stored on the server that contains all the files describing the behavior,
processing and rendering of a given software feature.
Each module is equivalent to a “plug-in” which extends the functionality of Jahia and manages one or
several specific business case.
Component: a component is an element that can be added to a Jahia page: it can be a simple piece of
content (an article, a news item, FAQ, etc…) or an actual functionality (a tag cloud, a search form, a
breadcrumb, etc…)
Each component is defined in a module. It is only defined once, but another module can use it with different
parameters.
For instance, the “user” component is defined in the “user” module with several rendering files, but is also
used and augmented in specific contexts such as in the Blog, DocSpace or Forum modules.
A module…
- may declare and define no component at all, but add a low level/core functionality, for instance
- may declare and define a unique component (example: all modules that define simple content structures)
- may declare several components (example: the FAQ module defines a “Q&A” component as well as a
automated “Table of Content” component).
The most advanced modules -which can be fully fledged applications-, can define up to a dozen
components usable independently or together, through the “Edit” or “Studio” User interface.
A module may contain
- Definitions (cnd format)
- Rendering files (jsp, velocity, freemarker...)
- Properties files (resourceBundles Java)
- Static resources (css, javascript)
- Component icons
- Rules (such as « Drools »)
- Workflow files (jBPM)
- Libraries or library sets in the form of a jar file (note: newlibraries have to be different from Jahia’s existing
libraries, to avoid any possible conflicts).
Page 4 / 26
1.1 Structure
tomcat/webapp/jahia/modules/
Modules placed under this repository are those that are meant to be customized to fit specific needs of
projects based on Jahia.
tomcat/webapp/jahia/modules/default/
Modules placed under this repository are those that either aren’t explicitly meant to be customized or those
that Jahia will update from release to release.
Should you need to customize one of these “default” modules for the specific needs of your project, we
recommend you copy and extend it directly in the /module/ repository – which is meant for this very
purpose.
How to turn on/off components defined in the modules displayed by the selector
A module can define one or several components that will appear in the user interface (and more specifically
in the selector), so that they can be handled by editors and webmasters. For a component to appear in the
selector, it is necessary to define a jmix property
Example: the “banner” component will appear in the “editorial components” of the selector.
[jnt:banner] > jnt:content, mix:title, jmix:editorialContent
1.2 Categories
There are, by default, 10 categories of components:










Content:Basic
Content:Multimedia
Content:Structured
Form Components
Layout Components
Lists
Search and Queries
Site Components
Social Components
Tags
Page 5 / 26
2 Editorial Composites
These modules define content structures and, for each, one or more views of typical use cases. These
modules generally do not contain any specific business logic, they are intended to display content and
organize for easier authoring.
2.1 Article
Article
/modules/article/
This module defines an object of type “article” that is very structured and complete. It combines a title, an
introduction (both unique), and a set of paragraphs based on my module "main content". The purpose
section also defines the ability of each paragraph to add an insert (highlights or quote) that will fit within the
text on the right or left of it.
This module is a good example for integrators who wish to understand how module inheritance works and
to develop components themselves, extending or integrating other objects.
[jnt:paragraph] > jnt:mainContent
- insertText (string, richtext) i18n
- insertType (string,choicelist[resourceBundle]) = quote indexed=no < quote, exergue
- insertPosition (string,choicelist[resourceBundle]) = left indexed=no < left, right
- insertWidth (long) = "150" indexed=no
[jnt:article] > jnt:content, jmix:editorialContent, mix:title, jmix:tagged
- intro (string, richtext) i18n
+ * (jnt:paragraph)
2.2 Banner
Banner
/modules/default/jnt_banner/html/ (rendu)
/modules/definitions.cnd (définition)
This module lets you select a banner (image) that will be used in the background of the DIV element
defined by the rendering file, and to associate a title and slogan.
Page 6 / 26
The title and slogan, as the rendering file is written, are displayed over the selected image. It is also
possible to define text placement by entering a left margin and top margin, from the corner of the photo.
[jnt:banner] > jnt:content, mix:title, jmix:editorialContent
- background (weakreference, file[mime='image/*']) i18n
- cast (string, richtext) i18n
- positionTop (long) indexed=no
- positionLeft (long) indexed=no
Possible customization:
- If the list of available images to create the banners is limited and known in advance, it is possible to
replace the image field by a predefined list, which will save time for publishers and avoid mistakes.
- Due to the superimposition of text on the image, it may be interesting to add a field to select text color –inline instruction type.
2.3 Big Text
BigText
/modules/default/bigText/
/modules/default/definitions.cnd
This module allows users to author text of unlimited length. In Edition Mode, the field appears with a
WYSIWYG editor.
It is recommended not to change this content structure.
2.4 Contact
Contact
/modules/contact/
This module allows you to insert a preset contact form directly in a page. The editor can choose fields on
the fly and before he wishes to display, among 15 available. Functionally, this module is very simple since it
only lists fields and stores a boolean (true / false) that is used to display or not the specific field, but it is a
good example of an alternative to the Jahia Form Builder module, that is more powerful, but requires more
time and control. If your project involves a few forms which structure is known and does not require the
creation of new forms on a regular basis, this approach is faster.
The forms’ output is stored in the repository and available in CSV format.
Page 7 / 26
2.5 External Link
External Link
/modules/default/jnt_externalLink/ (affichage)
/modules/default/definitions-nav-menu.cnd (structure)
This module allows you to insert an external link to the Jahia platform by choosing specific parameters such
as “target” and “alt”. It relies on a data type (jmix: navMenuItem) internal to Jahia.
2.6 File List
File List
/modules/default/jnt_fileList/ (affichage)
/modules/default/definitions.cnd (structure)
This module lets you select a folder of the Jahia Document Manager and automatically display its children
documents in a page. The main advantage is that the content list display is updated whenever the content
of the target folder changes.
[jnt:fileList] > jnt:content, jmix:editorialContent
- folder (weakreference, file[folder])
2.7 Flash
Flash
/modules/default/flash/html/ (affichage)
/modules/default/definitions.cns (structure)
This module is designed to insert an Adobe Flash animation on a page. It uses <object> defined by the
standard. When the flash component is inserted into a page, the editor/publisher may define all the
parameters for the Flash movie. Some of these parameters are not necessary and may be intentionally
deleted from the definition to limit the complexity for the editor. IMPORTANT: Please note that any
change in the definition file to remove a field must be completed before deployment of the definition
in question
[jnt:flash] > jnt:content, mix:title, jmix:editorialContent
- flashSource (weakreference, file)
Page 8 / 26
- width (string) analyzer='keyword' nofulltext
- height (string) analyzer='keyword' nofulltext
- flashPlayer (string) = '9' analyzer='keyword' nofulltext
- id (string) analyzer='keyword' nofulltext
- name (string)
- swliveconnect (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext < 'true', 'false'
- play (string, choicelist[resourceBundle]) indexed=no < 'true','false'
- loop (string, choicelist[resourceBundle]) indexed=no < 'true','false'
- menu (string, choicelist[resourceBundle]) indexed=no < 'true','false'
- quality (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext <
'low','high','autolow','autohigh','best'
- scale (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext < 'default','noborder','exactfit'
- align (string, choicelist[resourceBundle]) indexed=no < 'l','r','t','b'
- salign (string, choicelist[resourceBundle]) indexed=no < 'l','r','t','b','tl','tr','bl','br'
- wmode (string, choicelist[resourceBundle]) indexed=no < 'window','opaque','transparent'
- bgcolor (string, color) indexed=no
- base (string) indexed=no
- flashvars (string) indexed=no
2.8 Image
Image
/modules/default/image/
/modules/default/definitions.cnd
This module allows you to insert an image into a page, along with a text alternative. It can easily be
extended to include a css value, caption or other values.
2.9 Main Content
Main Content
/modules/default/jnt_mainContent/html/ (rendu)
/modules/definitions.cnd (définition)
This very generic module defines the structure of the most used content element that we call a "paragraph":
a title, body text (rich text), an image and a variable to align the image to the left or to the right of the text.
[jnt:mainContent] > jnt:content, mix:title, jmix:editorialContent
- body (string, richtext) i18n
- image (weakreference, file[mime='image/*']) i18n
Page 9 / 26
- align (string,choicelist[resourceBundle]) = left indexed=no < left,right,default
2.10 News
News
/modules/news/
This module allows you to manage news items. It comes with several renderings to display lists of news in
various formats (small, medium, large).
A component that displays the latest news is also provided which gives the editor/publisher the ability to
pick how many news items should be displayed, and a filtering criterion based on the category tree.
[jnt:news] > jnt:content, mix:title, jmix:editorialContent
- desc (string, richtext) i18n
- image (weakreference, file[mime='image/*'])
- date (date) = now()
[jnt:lastNews] > jnt:content, jmix:list, mix:title, jmix:queryContent, jmix:cache
- maxNews (long) = 10 indexed=no
- filter (reference, category[autoSelectParent=false])
- j:subNodesTemplate (string, choicelist[templates=jnt:news,resourceBundle,image]) nofulltext itemtype =
layout
2.11 Teaser
Teaser
/modules/default/jnt_teaser/html/ (affichage)
/modules/definitions.cnd (structure)
This module allows you to insert “slogans” in pages composed of a title, an image and link. Various
renderings are available to offer typical alternatives (links on the image link at the end of the text ...)
The “teaser” object is totally independent of the target object to which it refers, so it offers great flexibility.
Typical use cases are
- Home page for the promotion of certain parts of the site
- In the secondary columns, often displayed as a clickable image, as seen in many media sites.
[jnt:teaser] > jnt:content, mix:title, jmix:editorialContent
- abstract (string, text[multiline]) i18n
- image (weakreference, file[mime='image/*'])
- link (weakreference)
Page 10 / 26
2.12 Text
Text
/modules/default/jnt_text/html/ (affichage)
This module defines a component made of a simple short text field (255 characters).
It is recommended not to change the content structure.
2.13 Tree
Tree
/modules/default/jnt_tree/html/ (affichage)
2.14 Event
Event
/modules/event/
This module is designed to manage events (title, description, start date, end date, location, type of event).
Event types are defined in the definition and may be modified or replaced to use another “initializer” more
consistent with the needs of your project (external list, call for a list stored in the JCR .. .)
Adding registration functions to a given event can be achieved very easily by setting up a simple form,
shown in live mode, whose mission is to create sub-nodes to the event in question for each record, for
example.
[jnt:event] > jnt:content, jmix:editorialContent, mix:title
- startDate (date) facetable
- endDate (date) facetable
- location (string) i18n facetable
- eventsType (string, choicelist[resourceBundle]) facetable <
meeting,consumerShow,roadShow,conference,show,pressConference
Page 11 / 26
2.15 FAQ
FAQ
/modules/faq/
This module lets you build lists of frequently asked questions.
It consists of two distinct components:
- Summary of FAQs
- FAQ list
To build a simple FAQ, the second component is sufficient in itself. If you want to build a relatively long
FAQ, or organize it into sections, you must use the component summary. This includes a list of FAQs but
also, as its name suggests, a dynamic summary of all questions.
[jnt:faq] > jnt:content, jmix:editorialContent
- question (string) i18n
- answer (string, richtext) i18n
2.16 Job
Job
/modules/job/
This module allows you to manage jobs and receive job offers via an online form. The reply form is
extremely basic (name, email address, free text) and can / should be adapted to the needs of your project.
[jnt:job] > jnt:content, mix:title, jmix:editorialContent
- reference (string)
- businessUnit (string) i18n facetable
- contract (string, choicelist[resourceBundle]) facetable < contract1, contract2, contract3, contract4
- date (string)
- town (string)
- country (string, choicelist[country,flag]) facetable
- educationLevel (string) i18n analyzer='keyword'
- description (string, richtext) i18n
- skills (string, richtext) i18n
+ * (jnt:jobApplication)
[jnt:jobApplication] > jnt:content
- firstname (string)
- lastname (string) primary
Page 12 / 26
- email (string)
- text (string, richtext) i18n
2.17 Location
Location
/modules/location/
This module stores a geographical location or an address. It is typically used along with another content
item in order to make it contextually aware, or just to build a digital directory of locations. It can also be
associated to and enhance a roster or contact list.
Leveraging the latitude and longitude field described below, this module can also automatically display a
map by calling the Google Maps (or equivalent) API.
[jnt:location] > jnt:content, mix:title, jmix:editorialContent
- street (string)
- zipCode (string) analyzer='keyword'
- town (string) i18n facetable
- country (string,choicelist[country,flag]) i18n facetable
- latitude (string) i18n facetable
- longitude (string) i18n facetable
2.18 People
People
/modules/people/html/
This module is dedicated to manage biographical information, such as those typically found on the
« management team » section of a corporate web site, but also within knowledge bases.
This module isn’t redundant with the Jahia User management one, designed to control authenticated Jahia
users’ information. Therefore and to avoid data duplication, the « People » module should only be used for
non-authenticated/registered users.
- firstname (string)
- lastname (string) primary
- function (string) i18n
- businessUnit (string, choicelist[resourceBundle]) analyzer='keyword' facetable < sales,marketing, GA,
production, humanressources
- telephone (string)
Page 13 / 26
- cellular (string)
- fax (string)
- email (string)
- biography (string, richtext) i18n
- picture (weakreference, file[mime='image/*'])
Le champ businessUnit est initialisé à partir de la définition (definitions.cnd) par une série de valeurs
directement écrites dans le fichier cnd. Ces valeurs peuvent être librement modifiées, étendues, ou
remplacées par un autre initialiseur.
Le module est fourni avec deux vues différentes
/templates/people/html/people.jsp est la vue par défaut qui présente un abstract
/templates/people/html/people.full.jsp est la vue la plus complète qui présente tous les champs
2.19 Press
Press
/modules/press/
This module manages press releases.
[jnt:press] > jnt:content, mix:title, jmix:editorialContent
- date (date)
- pdfVersion (weakreference, file) i18n
2.20
Publication
Publication
/modules/publication/
This module defines a “publication” object that allows to describe in a generic way a specific publication
(title, author, release date, etc…). It can be easily extended to integrate typical fields related to
documentation or bibliography (bar code, SKU, ISBN, ISSN or any other code) or categorization (genre,
sub-genre, etc.). A downloadable file and a preview image can also be attached to the component.
[jnt:publication] > jnt:content, jmix:editorialContent, mix:title
- file (weakreference, file) i18n
- preview (weakreference, file) i18n
- author (string) i18n analyzer='simple'
Page 14 / 26
- source (string) i18n
- date (string) i18n indexed=untokenized nofulltext
2.21 Tasks
Tasks
/modules/tasks/
A compléter
2.22 Static HTML
Static HTML
A compléter
2.23 Frame
Frame
/modules/default/jnt_frame/html/ (affichage)
/modules/default/definitions.cnd (définition)
This module makes a « Frame » component available to editors, and its parameters can be defined (size,
scrolling, spacing...)
[jnt:frame] > jnt:content, mix:title, jmix:editorialContent
- source (string) indexed=no
- name (string) indexed=no
- width (long) indexed=no
- height (long) indexed=no
- frameborder (long) = '0' indexed=no
- marginwidth (long) = '0' indexed=no
- marginheight (long) = '0' indexed=no
- scrolling (string, choicelist[resourceBundle]) indexed=no < 'yes','no','auto'
- alt (string) i18n indexed=no
Page 15 / 26
2.24 Video
Video
/modules/default/video/html/ (affichage)
/modules/default/definitions.cns (structure)
This module inserts a video in a page. It uses the <object> tag defined by the standard. When the video
component is inserted in a page, the editor can define all parameters set by the W3C norm. It is possible to
predefine some of this parameters in an effort to shield editors from too much complexity.
[jnt:video] > jnt:content, mix:title, jmix:editorialContent
- name (string)
- source (weakreference, file)
- width (long) = '0'
- height (long) = '0'
- hspace (long) = '0'
- vspace (long) = '0'
- autostart (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext < 'true','false'
- invokeURLs (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext < 'true','false'
- enablecontextmenu (string, choicelist) analyzer='keyword' nofulltext < '0','1'
- showstatusbar (string, choicelist) analyzer='keyword' nofulltext < '0','1'
- showcontrols (string, choicelist) analyzer='keyword' nofulltext < '0','1'
- autosize (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext < 'true','false'
- displaysize (long) = '0' analyzer='keyword' nofulltext
- loop (string, choicelist[resourceBundle]) analyzer='keyword' nofulltext < 'true','false'
Page 16 / 26
3
Functional Composites
3.1 Author Display
AuthorDisplay
/modules/default/authorDisplay/ (affichage)
This module automatically and dynamically displays information related to the author of a specific piece of
content: it is meant to be bundled with a main component.
This module as well as its rendering can and is meant to be customized.
3.2 Back To Parent Page
Allows to insert a « Back to previous Page » link
3.3 Bookmarks
Bookmarks
/modules/bookmarks/
The Bookmarks module defines two components: the main « bookmark » component used in the User
Profile and that stores URLs and dates, and also a « bookmarkButton » component to be inserted
anywhere in Jahia pages or templates: with a simple click the user can store the current page in his/her
personal bookmarks.
Possible enhancements and customizations:
- One possible enhancement would be to couple this module with a thumbnail generation module : the
bookmark could be associated to a thumbnail that the user would pick within a gallery (sample thumbnail
services here :http://snapcasa.com/, http://www.thumbalizr.com/, http://webthumb.bluga.net/home, etc.)
- Another possible customization would be to add a « Notes » filed so the user can add comments to
his/her bookmark.
Page 17 / 26
3.4 BreadCrumb
BreadCrumb
This is simply a Breadcrumb module: drag n’ dropping this module in a page automatically displays the
breadcrumb from the home page to the current page.
3.5 Calendar
Calendar
/modules/calendar/
This module allows you to insert a calendar page, and to establish a connection between this and a content
list. Once the relationship established and the date fields defining the relationship selected (usually it is the
content creation date or modification date content) the calendar module will display, for each date, all
corresponding elements in the list, and a link on the date in question that will effectively filter the list on the
chosen date.
Possible enhancements:
The addition of a small simple form in live mode so that site visitors can add their own content in the list:
this would enable this module to be leveraged as “Classified” tool, or a public/private calendar , in just a few
minutes!
3.6 CSS Page
cssPage
/modules/cssPage/
This module, supplied as an example for a selective use to the specific needs of your project, allows a
publisher/editor to manage/edit a set of CSS style sheet, such as image and background color, size , colors
and fonts, color for links not followed, tracked, etc..
The values chosen by the user are introduced in the current page as an “in-line editing” type. Through this
approach, the original CSS is never changed but the user-defined styles have a greater priority.
This module provides great freedom and flexibility for users to pick and define their own look and feel.
Obviously, providing this tool to authors is great in the context of a blog or a personal portal page for
Page 18 / 26
instance, but may not be suitable to a corporate web site! It is possible to limit the amount of parameters
that users can control themselves.
[jnt:pageCss] > jnt:content, jmix:sandboxContent
- j:backgroundColor (string) = '' indexed=no
- j:bodyColor (string) = '' indexed=no
- fontFamily (string,choicelist) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman, Times, serif', 'Courier
New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial, Helvetica, sans-serif',
'Geneva, Arial, Helvetica, sans-serif'
- lineHeight (string,choicelist) indexed=no < '', '100%', '110%', '120%', '130%', '140%', '150%', '160%', '170%', '180%',
'190%', '200%'
- fontSize (string,choicelist) indexed=no < '', '80%', '90%', '100%', '110%', '120%', '130%', '140%', '150%'
- j:aLinkVisitedColor (string) = '' indexed=no
- j:aHoverActiveColor (string) = '' indexed=no
- j:h1Color (string) = '' indexed=no
- h1FontFamily (string,choicelist[resourceBundle]) indexed=no < '', 'Arial, Helvetica, sans-serif', 'Times New Roman,
Times, serif', 'Courier New, Courier, monospace', 'Georgia, Times New Roman, Times, serif', 'Verdana, Arial,
Helvetica, sans-serif', 'Geneva, Arial, Helvetica, sans-serif'
- j:colorResource1 (string) = '' indexed=no
- j:colorResource2 (string) = '' indexed=no
- img1 (weakreference, file[mime='image/*'])
- img2 (weakreference, file[mine='image/*'])
3.7 Current User
Current User
/modules/default/jnt_currentUserDisplay/html/ (affichage)
This module displays the name (username) of the currently authenticated user. It is typically placed on the
top of the page to alert the user that he/she is actually authenticated within the Jahia platform.
Page 19 / 26
It can easily be extended to display additional information (such as contextual data – weather, local time,
etc…), or as a foundation to create various components that need to rely on the current user authentication.
3.8 Facet
Facet
/modules/facets/
This module manages the capabilities of Jahia faceted search. It inserts a component of facets that can be
linked with the list of items to be faceted. Unlike other CMS that require developers to hard code facets,
Jahia can do this in the Jahia studio by single-click selection.
3.9 Form Builder
Form Builder
/modules/formBuilder/
This module allows to build a form directly inside a Jahia page, with fields and validation rules of all types,
as well as the resulting processing once the form is posted by a user.
Validation rules by default are:
- Mandatory
- Validation of a data range
- Syntax validation for email address
- Date validation
Developers can add additional validation rules. Once declared as components of forms, they become
available fields in your forms.
3.10 Language Switcher
Language Switcher
/modules/default/languageSwitcher/ (affichage)
Page 20 / 26
This module inserts, in a Jahia page, one link per active language on the site, allowing users to switch from
one language to another. It currently ships with a single rendering type, but additional renderings (with or
without a national flag, as a drop-down list, etc..) will be added later.
3.11 Latest
Latest
/modules/latest/
This module defines two components:
- List of recently created or modified pages (to be chosen by the user)
- List of recent content of type X (user choice) created or modified
From these two examples, it is very easy to create, if needed, a list of ready-made components stemming
from the same principle, according to the functional needs of your project (list of recent articles, recent
users, the most recent comments ...)
3.12 Login Form
Login Form
/modules/default/loginForm/html/ (affichage)
This module displays an authentication form. When the user is authenticated, the module displays his/her
username.
3.13 Navigation Menu
NavMenu
A compléter.
This module manages the Standard Jahia navigation, which incorporates the exact tree of pages and links
created in the selector. It is possible to choose the starting level of the menu, and its level of depth as well
as a CSS class to change his appearance instantly (see “Menus”)
Page 21 / 26
3.14 Page Tagging
Page Tagging
This module displays a form that visitors can use to add a tag to the current page. Note that the component
tag cloud (tag cloud) is defined in the module called “Facets”.
3.15 Page Title
Page Title
/modules/default/jnt_pageTitle/ (affichage)
/module/default/definitions.cnd (structure)
This component displays the title of the current page. It is primarily intended for use when building
templates. The rendering file defines the display of the title in a <h2> tag with a "pageTitle" class.
A quick enhancement would give the ability for publishers to choose the level of title to be used (h1, h2, h3)
or its color, etc...
We could also imagine extending this component to automatically display the page author, creation date
and / or date of last modification for example.
3.16 Poll
Poll
/modules/poll/
This module provides polling capability to Jahia. The editor defines the question and “n” possible answers.
The calculation functions are implemented but the result of the vote (the display) is very basic (a skeleton
model) and is meant to be customized according to the specific project requirements.
3.17 Portlet
Portlet
This module allows Jahia users to insert a portlet (JSR 168 / JSR 283) within a page.
Page 22 / 26
3.18 Query
Query
/modules/default/jnt_query/html/ (affichage)
/modules/efault/efinitions.cnd (structure)
With this module, Jahia users can drag n’ drop, in a page, a query result (SQL2, QOM or XPath). Upon
component activation the editor can enter the desired query in a field.
3.19 Rating
Rating
/modules/rating
This module allows users to propose to rate a page or a piece of content.
The voting system and its graphical representation on the page are both available in two versions
- Stars: typical rendering with 5 stars. The score is the sum of all votes –out of 5- divided by the total
number of voters.
- Plusone_minorone: this rendering is often found in forums or the user may vote +1 or -1. The note is the
addition of the votes + and -.
The module also comes with a component to display the best rated contents.
3.20
RSS
Rss
This module allows to define an RSS feed URL and the desired amount of feeds to be rendered in the
page.
3.21 Search
Search
/modules/search/
A completer
Page 23 / 26
3.22 Shortcuts
Shortcuts
/modules/default/jnt_shortcuts/
/module/default/definitions.cnd
This module inserts a series of links defined directly in the JSP rendering fil. By default, it bundles:
- A logout from Jahia feature
- Display of the username for the current user (if connected)
- A shortcut to the personal page of the user logged
- A feature that allows for changing the font size in the page
- Links to switch to edit mode or contribution (according to user’s access rights)
- A shortcut to the home page of the current site
- A shortcut to the site map
3.23 Twitter
Twitter
/modules/twitter/
This module defines currently two components
- TwitterSearch: displays, within a page, a simple search box that dynamically outputs the resulting twitter
feed. The search object is not stored in the JCR, this is just a parameter passed on the fly to get a result.
- TwitterFeed: Defines a search/query tag, which is stored in the JCR. The component thus permanently
displays the resulting live Twitter Feed.
3.24 Top Stories
Top Stories
This module adds a feature to the standard edition engines so that with a single click, content
authors/publishers/editors can drag n drop a "top stories" block anywhere on a Jahia page.
The module supports by default three hierarchical levels among which publishers can choose from, and
can easily be simplified if the top stories do not need to be graphically highlighted or prioritized.
Page 24 / 26
3.25 Sitemap
This module brings an extra capability to Jahia Edit mode.
Upon activation it adds the current element (such as a page) in sitemap.xml file that meets the standard
defined by Google. The author/editor/publisher can also define the importance of the element and the
frequency with which Jahia will ask Google to re-index this item. This is a key capability that allows site
managers to augment site visibility and Search Engine Optimization (SEO).
A less granular but more automated approach may be considered: the sitemap.xml could be automatically
created, without human intervention by systematically inserting specific content types, for example.
This module is a good model to systems for integrators who wish to display their own options in Jahia
interfaces.
3.26 User Registration
User registration
/templates/userregistration/html/ (affichage)
/templates/userregistration/definition.cnd (structure)
This module, once inserted into a page, is presented as a form for users to self register into Jahia. Upon
insertion of the component in a page
- It is possible to notify the relevant administrator(s) that a new user has registered (by email)
- The landing page (where the user is redirected after the form is submitted) need to be set.
By default, the following fields are displayed and marked as « mandatory » (this, of course, can be
customized)
- First Name
- Last Name
- Username
- Password
- Email
The form can obviously be extended at will, with any additional user property.
<input type="text" name="property_name" id="property_name" value="" tabindex="xx"/>
Registering a user triggers an automatic email to the administrator of the platform, and a welcome email to
new registered user.
On the server, the Jahia folder Userregistration folder / mail / templates / contains the template used for
these automatic notifications: this template accepts HTML and can be customized easily.
Page 25 / 26
Jahia Solutions Group SA
9 route des Jeunes,
CH-1227 Les acacias
Geneva, Switzerland
http://www.jahia.com
Page 26 / 26

DOCUMENTATION Jahia 6.5 Content Composites

Transcription

Similar documents

Flemish String Board Attachment

Basic Information - Tecnológico de Monterrey

READY TO FLY!!!

How-to use spring configurations to extend Jahia D

in pdf format here - UNGEGN Norden Division

gruffalo`s child

A Question of Scale

here - Marilyn McNeal

Making String Heddles for the Gilmore Inkle Loom

sponsorship package

Knotted Friendship Bracelet