How do I use the content editor?

Grant Pankonien — Mon, 03 Aug 2020 18:26:10 GMT

Current Revision posted to User Documentation by Grant Pankonien on 08/03/2020 18:26:10

This guide applies to all editors through Telligent Community, however, the editor is subject to configuration specific to individual types of content and not all features will be available everywhere. See [[How do I control the type and functionality of content that can be posted on my community?]]

Throughout Telligent Community, a common content editor is used. It is shown in different forms, but provides consistent access to content-related functionality. This guide identifies key features within the editor.

[toc]

What is the content editor?

The content editor is the rich text editor used through Telligent Community that enables formatted text to be authored. It is shown wherever rich content can be defined:

Basic Editing

The editor's menu provides access to common editing functionality such as search and replace, insertion of rich elements, formatting options (such as bold, italic, code, headings, etc), color selection, font selection, text indentation, table definition, content previewing, and HTML source editing.

These features work like modern word processors to manipulate text in a "what you see is what you get" way.

Inserting Files

Files, such as images, videos, audio, and documents, can be included in content. Files can be inserted via the Insert > Insert image/video/file menu option, by dragging the file onto the editor, or by copying the file and pasting it into the editor. Note that copy/paste is subject to the browser's default interpretation of the content being copied and may not work for all file types. Inserted files will be previewed based on the enabled file viewers in Administration > File Viewers.

Once placed, files will render a preview that can be resized to meet the rendering needs of the content. If a file should be rendered as text (to just enable downloading), select the file and select Convert to link from the contextual toolbar:

Linking to URLs

URLs to external websites and pages can be added to content by typing the URL as text (the editor will automatically change URLs to links for most URL types), by using the Insert > Link menu option, or by referencing a URL in the Insert > Insert image/video/file menu option.

To convert a link to a preview, select the link and choose Edit > Convert link to preview:

Insert an Emoticon or Emoji

Emoji can be entered using your computer or device's emoji keyboard, by searching by typing the : prefix, or via the Insert > Emoticon option. Enabled emoji (based on configuration in Administration > Site > Emoticons) will be converted to the site-defined image representing that emoji.

Insert a Mention

A mention can be added by typing @ and then text to search for a member or a group. Matching results will be listed and can be selected using the touch, mouse, or arrow keys. When saved, the mention will change to a link to that member or group. The member or group mentioned will also potentially get a notification that they were mentioned in the content to prompt their review.

Insert a Hashtag

A hashtag can be added by typing # and then text to search for an existing hashtag (or to define a new one). Matching results will be listed and can be selected using touch, mouse, or arrow keys. When saved, the hashtag becomes a link to find related content using the same tag/hashtag.

Insert a poll, embed code, source code, or other rich embeddable

Telligent Community supports extensions to the editor to enable embedding rich media. These extensions are enabled and configured within Administration > Extensions and include polls, embed codes (such as Twitter, Youtube, Facebook posts, etc), and syntax highlighted code embedding. For more details about individual extensions, search the documentation for specific functionality. Enabled extensions will be listed in the Insert menu of the editor.

Edit in Fullscreen Mode

To edit content in a larger editor (that fills the browser window), select View > Fullscreen. To exist fullscreen mode, select View > Fullscreen again.