Wyvern is built to provide the best content entry workflow possible. It is the first and only editor that integrates seemlessly with all of these popular modules: Structure, Pages, Taxonomy, NavEE*, SafeCracker/Channel Form, and Assets. It was the first ExpressionEngine editor to include a visual editing mode to see separations in your content blocks so your editors do not get confused and mangle the content.
{page_url:23} 23 is the Entry ID of the page you are linking too. Start linking to pages based on ID, not the URI. This makes the site more portable, and easier to update. TIP: You don't have to use the Wyvern Fieldtype to take advantage of these global variables. As long as you are using Pages or Structure modules, just enable the Wyvern Extension, and you are good to go.Make sure your system meets the minimum requirements:
Updating to EE3 requires some manual handling due some structure change. EE3 comes with a new concept of creating toolbars, which differ from EE2.
No data will be touched by the updater
The development for EE2 has been stopped per v2.0.0 The docs for EE2 can be found here
For every paid addon you need to validate your license in order to activate the module.
On a local environment, like *.dev *.local *.localhost *.test the license is valid for testing and building a new or existing sites.
For every other domain, you need to have a valid license.
Once installed, you will asked to enter your license key. When you entered a valid license you can hit the "Save license" button. This will start validating your license and will redirect you to addons.reinos.nl to login into your account. You can also register a new account in this process.
Once logged in, you are asked to use your current account or to login with another one.
Using the current logged in account, the server will check all info related to your license and once valid, it will redirect you back to your site where you see either a success message or an error message.
This module is using a license field to check if the license for the module is valid or not. On addons.reinos.nl you can check your license and add your valid domains.
In the Module CP you can enter then your license
When you enter a wrong license, the module will not work and it shows you an warning
Sometimes it happens that the license system says you have an invalid license. When this happens, make sure you have entered your domain url in your account, next to your license on addons.reinos.nl.
If this will not fix your license problem, please contact us on https://addons.reinos.nl/support
This is the path to the CSS file used to define custom styles used within the CKEditor field. If you define a CSS file, a JavaScript file is required below.
The default location is: /themes/user/wyvern/wysiwyg/wysiwyg.css
This is the path to the JavaScript file used to create the select menu in the toolbar. It will normally contain definitions to the styles defined in the CSS file above.
The default location is: /themes/user/wyvern/wysiwyg/wysiwyg.js
This will obfuscate (encode) email addresses when used within Wyvern fields. This will automatically link email addresses too.
This will add dashed borders and visual markers to HTML containers.
Set any additional CKEditor configuration options here. A list of possible options can be found in the CKEditor API. Set the options in the following format, one option per line and no quotes (the module will handle that for you). You can also use {site_url} or {base_url} as a variable to link extra files.
Select which file manager to use. You can use the native EE File Manager, or Assets.
Select which templates you want to display in the Link Dialog Template list. Options are all templates template group custom range
Height in px of the field
This makes the field resizable by default
This will make the field grow as you type
Select per membergroup the toolbar you want to show
Set the text direction for the field
Select the upload folder.
This will turn url and email into a link
Allow image url in the field or not.
What is the tag for the enter
In this field you can add your css that will only loaded for this field.
By default the field CSS will load both the custom CSS as also the Global style (defined in the Module CP).
By setting this setting to off it will only load the custom CSS that is defined for this field only.
By default, Wyvern intentionally comes with 3 sets of CKEditor buttons.
However, you can create as many toolbars you want via the smart toolbar manager.
word_limit
Optional: Limit the content to a specific number of words.
suffix
Optional: If using the limit parmeter this allows you to add a string of text after the limited text, such as a "Read More" link.
{field_name word_limit="50" suffix="..."}character_limit
Optional: Limit the content to a specific number of words.
suffix
Optional: If using the limit parmeter this allows you to add a string of text after the limited text, such as a "Read More" link.
{field_name word_limit="50" suffix="..."}strip_tags
Optional: Strip al tags for the wyvern field
allowable_tags
Optional: which tags are allowed
{field_name strip_tags="yes" allowable_tags="<p><a>"}Add a class to your images in your Wyvern field
{field_name image_class="img-responsive"}Wyvern is powered by CKeditor 4.x.x. Also Wyvern will try to ship the latests release on every release of the module.
There are a lot of modules that are used with CKeditor and I will not document this here (of course ;-)) To find the right documentation you can navigate to this page where you can find all modules that are used inside the CKeditor
Wyvern support migration from (and to) RTE fieldtype. However, if you are coming from the RTE fieldtype you have the save the field settings twice.
If you are updating a site from EE2 to EE3 you probably run into some trouble with Wyvern. To fix the issues, you will have to follow the following steps if you have some kind of PHP errors.
http://yourdomain.com/system/index.php?/cp/addons/settings/wyvern/uninstall[?s=......]
this wil uninstall only the addon tables and does not remove or change any of your entries. If this does not work, you can contact us via http://addons.reinos.nl/support
With the Javascript API, you are able to set the content for an wyvern instance.
Execute a callback function when the Wyvern editor is ready
REINOS_WYVERN.ready(id, function(){
// you callback code
});Set the content of a Wyvern instance
REINOS_WYVERN.setContent({
id: 'id-of-the-instance',
content: 'override content',
defaultContent: 'Some default text',
});Practical use case for channel form, setting a default value
{exp:channel:form id="wyvern" channel="wyvern" return="site/channel-form" include_assets="yes"}
<input name="title" type="text">
<input name="url_title" type="text">
<div class="wyvern-channel-form">{field:wyvern}</div>
<input type="submit" value="Submit">
{/exp:channel:form}
<script>
window.onload = function(){
var id = document.querySelector('.wyvern-channel-form textarea').dataset.id;
REINOS_WYVERN.ready(id, function(){
REINOS_WYVERN.setContent({
id: id,
content: 'override content',
defaultContent: 'Some default text',
});
});
}
</script>$curl::last_responsenull stringREINOS_WYVERN.ready(id, () => {})REINOS_WYVERN.setContent({id: id, content: 'override content', defaultContent: 'Some default text'});field_id was undefinedBreaking changes
Unable to load the requested class: wyvern_lib *Note: There is a change you will have to validate the license again
images_class="" param to add a class to your images in your wyvern fieldchannel_entries_tagdata_end and replace it with template_post_parse for better performance [EE3/EE4] *Note: you need to add your license key and license email from addons.reinos.nl in order to validate your license and add a valid domain url in your license field on addons.reinos.nl/profile/licenses or the module will not work on a live site. Also make sure you have read the license section in the documentation
/ but is just empty{page_url:<entry_id>} in the link dialog as link{template_url:<template_id} in the link dialog as link