Linking Internally
One of the most important requirements for any WYSIWYG editor is that it needs to be easily link to pages within CMS Made Simple. And that is exactly what you get. To link to a page internally, just select the text that is to be the link and click on the link button on the editor toolbar. Once the window opens, you should notice inside the Quick links dropdown is a list of all the pages on your web site. Selecting a page from that list will update the URL text field with that page's link. Note that currently this will build the URL based on the hierarchy of your web site using pretty urls.
You can also have this generate a tag link instead. Just make sure the checkbox of Use tag is selected. It will generate the tag in the following format: {cms_selflink page="[alias]"} . It will replace [alias] with the alias of the selected page.
File Management
Spaw comes with a file manager so of course DL Suite: Spaw will come with that file manager. Difference? It has been made to be more useful. The original editor of Spaw does not allow you to see files in a directory that is not specifically specified in the configuration file. Not ideal in our case because we are allowed to create sub directories. No need to worry about that however, I have coded in a work around for this. It will update the allowable directories each time you make a change to the directory structure.
Settings
More information on the settings used by Spaw can be found on their web site. However, much of the information below should give you enough information to change them.
- Language: The default language for Spaw. Currently the only language supported in English but more will be added very soon.
- Theme: The theme that will be used for Spaw. The theme will determine how the Spaw editor looks like.
- Toolbar: The toolbar set to be used in the Spaw editor. If you need a lot of control, use All, but most of the time, Standard should be more than enough to do it.
- Width: The width of the editor. This value should be a positive integer and you should assume it to be pixels. You can also specify this with the text "auto" in which case, it will try to expand the width to 100% of the available space.
- Height: The height of the editor. This value should be a positive integer and you should assume it to be pixels. You can also specifiy this with the text "auto" in which case, it will try to expand the height to 100% of the available space. Though I advise you to not use auto here because it can have some unwanted effect in certain browsers.
- Use Iconv: Whether or not Iconv should be used. Don't know what it is? Google it.
- Rendering Mode: The mode used to render the XHTML. If set to builtin, it will use the browser's rendering mode which is different across different browsers. Better to use XHTML which uses Spaw's rendering engine.
- Beautify Output: Whether or not the output should be cleaned up by Spaw.
- Strip Absolute Urls: Whether or not we should strip absolute urls (of links to your site) so that it can be relative urls.
- Editor Resizing Direction: The resizing direction a user can do when they try to resize the editor.
- Convert HTML Entities: Whether or not HTML entities should be converted.
Dropdown Styles
The dropdown styles themselves should be self explanatory. However, the syntax is a different story. Nevertheless, it is very easy to understand.
The syntax contains two special symbols, => and |. The symbol | is used to separate each item while the symbol => is used to separate the key from the value. In all of the cases, the key is the value that the Spaw editor uses to update an element when you want to change its style. The value is the text that you see in the dropdown.