Paragraphs

A page consists of a number of paragraphs. These paragraphs put together make up the whole page including headlines, text, images and links.

Thus, for each page in Dynamicweb, you can create one or more paragraphs, which can:

Paragraphs which are added to a page will appear on the paragraph list view of the page (Figure 1.1).

Figure 1.1 The paragraph list view

Paragraphs may be marked with one or more adornments (Figure 1.2) -  which are quick ways to see if this paragraph is affected by various settings og functions.

Figure 1.2 Paragraph adornments

To create a new paragraph:

  • Go to a page
  • Click New paragraph in the ribbon bar (Figure 2.1).
Figure 2.1 Creating a paragraph

This opens the paragraph-type selector (Figure 2.2), from which you can select either a blank page – the default page type – or any page-items you may have created on your solution.

Figure 2.2 Selecting a paragraph type

Whichever type you select, you will be prompted to name the page – you can rename it later if you want to – and click OK.

You will be taken to the paragraph content view.

The paragraph content view (Figure 3.1) is where you work with paragraph content like texts and images.

Figure 3.1 The paragraph content view

The paragraph content view consists of:

  • A toolbar with several tabs for working with and controlling the paragraph behavior – read more below
  • A content area, where you can add and work with content.
  • A footer, where administrative details about the paragraph are displayed; name, paragraph ID, creation date, last edit date, and the currently active paragraph template

For default paragraphs, as the one shown above, the content area consists of:

  • A name field
  • rich text editor field
  • An image selector
  • A number of image settings

You can use these fields to create and add content to the paragraph.

In contrast, the content area of an item-based paragraph depends on the item fields added to the paragraph item type – read more about items.

To use any of the Dynamicweb apps– like the Product Catalog app and the Shopping Cart app for Ecommerce, or the Forms for Editors app – you must add them to a paragraph.

To do so click the App button in the paragraph ribbon bar (Figure 4.1

Figure 4.1 The app button

This will open an app selector panel (Figure 4.2), where you can select the app you want to use.

Figure 4.2 The app selector panel

Selecting an app takes you to the app settings for that app, from where you can configure the app behavior.

When creating or editing a paragraph, you have access to four different toolbar tabs.

With these, you can customize paragraph layout and behavior, and how the paragraph interacts with other parts of the system.

The content tab (Figure 6.1) is the default tab when you create or edit a paragraph.

Figure 6.1 The Content tab

From the content tab you can:

  • Open the page containing the paragraph by clicking the Show button
  • Switch between the text view and the app view – see above
  • Select a custom paragraph templateread more about paragraph templates here

If you have more than one website language on your solution, you can switch between language layers using the languages dropdown.

Next you have the Options tab (Figure 7.1).

Figure 7.1 The Options tab

From the options tab you can:

  • Set a publication period activation date and deactivation date – the page will only be published during that time span. The end date year can be set to never if you want to page to remain published indefinitely.
  • Check the hide for phones/tablets/desktops option if appropriate (these are mainly supported for legacy reasons)

The advanced tab (Figure 8.1) contains settings of a more advanced nature.

Figure 8.1 The Advanced tab

From the advanced tab, you can:

  • Click permissions to access the permissions settings for the paragraph – read more about permissions
  • Click versions to access previous versions of the paragraph, provided you are using the versions workflow – read more about the versions workflow
  • Click Item type to change the page item type. The item type is not changed before you save the page.

The language management settings allow you to lock language versions of the page on all language layers and to restore language layer versions of the page to match the master page using the languages button – read more about working with language layers. These settings are only available if your website has language layers.

Changing item types

If you change the item type of a page, all item content is lost. This is irreversible.

You can change from an item based page/paragraph to an ordinary page/paragraph by selecting "Nothing selected" in the Item type dropdown, unless disable standard paragraph and/or Disable standard page is selected in Settings > Editing > Interface settings.

You can change from an existing ordinary page/paragraph to item based page or paragraph without losing existing content.

Finally, we have the marketing tab (Figure 9.1). 

Figure 9.1 The Marketing tab

From the marketing toolbar, you can set up personalization on the paragraph, and add personalization points to the personalization profiles you have created – read about personalization of content in Dynamicweb here.

From the paragraph list view on a page you can right-click any paragraph to bring up a contect menu (Figure 10.1).

Figure 10.1 The right-click menu for paragraphs

With the context menu, you can:

  • Click Edit to go to the paragraph content view
  • Click Copy or copy here
  • Move the paragraph (to move internally on the page, simply use drag and drop)
  • Exclude/Include the paragraphs from being shown on the frontend
  • Insert a new paragraph before or after the one you right-clicked on
  • Delete the paragraph

These actions, excepting insert before and insert after can also be accessed from the Page Tools toolbar.

Global paragraphs allow you to use (and reuse) paragraphs across your Dynamicweb website.

Using global paragraphs you can include a single paragraph's content, settings and app output on several pages of your website. This is useful if you want the same information on several pages, e.g. a list of news items or a calendar.

With global paragraphs, you can edit the source global paragraph in one location, making the changes available immediately on every page with the global paragraph attached. In effect, each global paragraph instance is a virtual paragraph, inheriting all properties of the source global paragraph.

To create a global paragraph go to the page where you want to add a global paragraph and click the Global element button (Figure 11.1)

Figure 11.1 To add or create a global element to your webpage, click 'Global element' in the toolbar

This opens the global element overview (Figure 11.2).

Figure 11.2 The global element overview

From here, select one or more existing global elements – or select a paragraph to make into a global element by clicking the Add button.

Once you’ve made your selection, click Include selected to include the selected global paragraphs on the current page.

Global paragraphs can be edited from any instance – you will actually be editing the source paragraph. Including or excluding a global paragraph affects all instances of the paragraph – as does deleting it.

Database

This is the database table associated with paragraphs:

Paragraph

Contains data on paragraph content. Relationship with a page is defined by ParagraphPageId and sorting within that page by ParagraphSort. If a paragraph has an app attached the type is set by ParagraphModuleSystemName and settings are defined by the XML document in ParagraphModuleSettings. Permissions are defined by the XML document preset in ParagraphPermission.

Field name Data type Length
ParagraphId int 4
ParagraphPageId int 4
ParagraphModuleSystemName nvarchar 50
ParagraphIndex bit 1
ParagraphSort int 4
ParagraphHeader nvarchar 255
ParagraphShowHeader bit 1
ParagraphShowParagraph bit 1
ParagraphSubHeader nvarchar Max
ParagraphText nvarchar Max
ParagraphIgnoreBreaks bit 1
ParagraphImage nvarchar 255
ParagraphImageURL nvarchar 255
ParagraphImageTarget nvarchar 250
ParagraphImageNewWindow bit 1
ParagraphImageMouseOver nvarchar 255
ParagraphImageCaption nvarchar 255
ParagraphImageResize bit 1
ParagraphImageVAlign nvarchar 255
ParagraphImageVSpace int 4
ParagraphImageHAlign nvarchar 50
ParagraphImageHSpace int 4
ParagraphTemplateId int 4
ParagraphValidFrom datetime 8
ParagraphValidTo datetime 8
ParagraphCreatedDate datetime 8
ParagraphUpdatedDate datetime 8
ParagraphBottomSpace int 4
ParagraphModuleSettings nvarchar Max
ParagraphUserCreate int 4
ParagraphUserEdit int 4
ParagraphImageLinkTarget nvarchar 255
ParagraphWorkflowId int 4
ParagraphWorkflowState int 4
ParagraphInheritId int 4
ParagraphInheritUpdateDate datetime 8
ParagraphInheritStatus int 4
ParagraphApprovalType int 4
ParagraphApprovalState int 4
ParagraphVersionTimeStamp datetime 8
ParagraphGlobalId int 4
ParagraphMasterParagraphId int 4
ParagraphPreview bit 1
ParagraphCopyOf int 4
ParagraphModuleCSS nvarchar Max
ParagraphModuleJS nvarchar Max
ParagraphContainer nvarchar 255
ParagraphTemplate nvarchar 255
ParagraphPermission nvarchar Max
ParagraphMasterType int 4
ParagraphVariation int 4
ParagraphItemType nvarchar 255
ParagraphItemId nvarchar 255
ParagraphHideForPhones bit 1
ParagraphHideForTablets bit 1
ParagraphHideForDesktops bit 1
ParagraphUniqueId uniqueidentifier 16
ParagraphColumnsLarge int 4
ParagraphColumnsMedium int 4
ParagraphColumnsSmall int 4
ParentContainer nvarchar Max
ContainerId nvarchar Max