Long Text element

This element is used for long text passages like product descriptions, sidebars, news articles - or even whole pages. The text content of this element can be formatted by the user with some rudimental formatting options (like bold text or bullet lists). If you as the designer wish to stay in partial control of the text styling, then the long text element is a good choice. The formatting possibilities are listed below.

The Long Text element code

<?php webyep_longText("Fieldname", false, "", true, 600, 400); // WebYepV2 ?>

Arguments for the function call

1. "Fieldname": A string - the field name for this element.
2. true/false: A boolean - the scope for this element.
   true if the element should have the same content on all pages (global).
   false if it should have different content on each page it appears on
3. "": A string - obsolete, pass an empty string ("").
4. true/false: A boolean - whether email links should be encoded.
   true if email addresses entered in the text element should be encoded using Javascript.
   false if they should be simply output as HTML.
5. 600, 400: Maximum width and height of the editor window.

Screenshots

Formatting options

The user can use the following formatting options to format the text entered:

The formatting option <EXAMPLE Some text in a special style> assumes that you have defined a CSS style ".EXAMPLE" in your page/website. It is important to use only uppercase letters in such CSS styles.

Placing the Long Text element

Please always remember that the Long Text element produces HTML code! When the user creates a bullet list for example the Long Text Elements creates <ul> and <li> HTML tags. Thus it is important to place the Long Text Element at a position in your page where such HTML tags are allowed!

The safest place is inside a <div> tag. Not ideal would be a paragraph (<p> tag) as HTML does not allow bullet lists inside a paragraph.

If you find your Long Text element placed inside a <p> tag you can change it into a <div> tag by clicking the <p> tag in the Tag Selector with the right mouse button and choose "Edit Tag...".

Formatting lists

The Long Text Element creates bullet lists by using the <ul> and <li> HTML tags. Therefore you can format these lists by defining CSS styles for these tags.

For example you could create a style:

ul {
  list-style-position: outside;
  list-style-image: url(bullet.gif);
}

to define the image "bullet.gif" as the bullet symbol used in all lists.

If you want your style to only change the look of lists inside the WebYep Text Element (and not all lists in the page), embed the Text Element in a <div> tag, give that tag a CSS class (class="someclassname") and change the name of the above style from "ul" to ".someclassname ul".

To only style list items of a specific indention level, you need to repeat the tag name ("ul") in the CSS style's name (selector):

.someclassname ul ul { .....; }

for instance would only define the style for second level items and deeper, but not the main items.

To style ordered lists created with the "+" sign, use the ol tag name instead of ul in the style names above.

Formatting tables

To change the look of tables, you simply create the usual CSS styles for the <table> and/or <td> tag - e.g.:

table {
  margin: 0px;
  padding: 0px;
  border-top: 1px solid black;
  border-left: 1px solid black;
}

td {
  margin: 0px;
  padding: 6px;
  border-bottom: 1px solid black;
  border-right: 1px solid black;
}

If you want your styles to only change the look of tables inside the WebYep Text Element (and not all tables in the page), embed the Text Element in a <div> tag, give that tag a CSS class (class="someclassname") and change the name of the above styles from table to .someclassname table and from td to .someclassname td.

Attributes of the Long Text element

Fieldname

A distinctive name for that element. This name will be displayed in the page in edit mode to give the user a hint on what this elements content stands for and to distinguish the different WebYep elements in a page.

Content

When set to "for this doc only" the elements content is unique for this page - even if another element on a different page has the same name. If set to "for all documents" the content will be the same on all pages for elements of this kind that use the same name.

Encode email links

If a user enters an email address into a Long Text Element, WebYep will display it as a clickable link ("mailto" link).

If you enable the "Encode Email Links" option, WebYep will encode these links to keep SPAM spiders from collecting the email addresses.

To do so, WebYep uses a Javascript based encoding. If the visitors of your website have deactivated Javascript, they will only see these email addresses in the form:

name(_AT_)domain.com

and the email addresses will then not be clickable.

Modal window size

As the developer you can preset the dimensions of the modal window size.