How to Edit and Customize HTML Snippets Using the WYSIWYG Editor

Starting from version 1.3 of the Sendent app for Nextcloud, you can edit HTML snippets using a new WYSIWYG editor available in the settings page. This editor allows you to use common formatting tools to change the snippets inserted into email bodies.

To start using the new WYSIWYG editor, you need to update the Sendent app for Nextcloud to version 1.3 and above.

To access and toggle the WYSIWYG editor, navigate to the Sendent settings page by:

1. Click on your profile icon and click on Administration Settings.

2. From the sidebar menu, click on the Sendent option.

3. Navigate down to the group settings section and switch to Sendent for Outlook option.

4. You will notice a "Toggle editor" button next to the respective snippet settings. Click this button to open the WYSIWYG editor and start editing your snippets.

5. Click on the Toggle editor button to open the editor and start editing your snippets.

Here's an overview of snippets you can edit

Inserting Your Company Logo

To insert the Logo, click the Logo button from the toolbar.

Note: The logo used is determined from the logo set within Nextcloud's theming options.

Inserting Tags

The WYSIWYG editor allows you to place tags at your chosen locations within the HTML snippet. The Outlook add-in will later replace these tags with the relevant data.

Click the Tags button.
Choose the desired tag, which will be inserted at your cursor's position.

Available fields in snippets

Here is a list of the available tags that you can insert from the Tags menu:

{URL} or {0} - Share link *

{PASSWORD} or {1} - Share password **
{EXPIRATIONDATE} or {2} - Share expiration date *

Other Available Tags

{FILES} or {3} - List files (uses <ul><li> tags)
{RECIPIENTS} - List recipients
{FROM} - List from sender (e.g. info@sendent.nl)
{SUBJECT} - Subject name
{CURRENTDATE} - Current date
{CURRENTTIME} - Current time
{LOGO} - Display set Nextcloud logo from theming

Custom HTML snippets containing CSS are supported. Whenever designing a custom HTML snippet, it is recommended to use HTML tables. We recommend using HTML tables as it is more convenient for the end-user to copy for example the password from the email.

Other techniques may cause inconveniences. The main issue is that by default, Windows behaviour adds a space at the end of any word selected. Therefore, when an end-user copies the password, they will accidentally copy a space with the password. When the end-user attempts to authenticate with the share, this will fail due to the copied password containing an unintended space at the end of the password.

* = REQUIRED
** = REQUIRED unless “Password communication mode” = “include in separate email”

Reset HTML Snippet to Default

If needed, you can reset the HTML snippet to its default settings by clicking the Reset button in the WYSIWYG editor.

If you prefer not to use the WYSIWYG editor, you can write and edit raw HTML directly from the source code page. To access this feature as an Admin, follow the steps below:

Click the Tools tab from the menu and click the Source code option.

On the Source code page below, you can write and edit HTML snippets freely as you wish.

Click the Save button once done.