Sourcerer is packed with options, giving you control over how it works and behaves. Here is the full list of the options you can find in the Sourcerer system plugin settings:
Here you can set what kind of code can be used within the Sourcerer tags. All code that is not permitted will be stripped away.
| Allow CSS tags | If enabled, CSS (style & link) tags are permitted within the Sourcerer tags. Otherwise the CSS tags (and the CSS code within) will be stripped. |
| Allow JavaScript tags | If enabled, JavaScript (script) tags are permitted within the Sourcerer tags. Otherwise the JavaScript tags (and the JavaScript code within) will be stripped. |
| Allow PHP tags | If enabled, PHP tags are permitted within the Sourcerer tags. Otherwise the PHP tags (and the PHP code within) will be stripped. |
| Forbidden PHP functions | A comma separated list of PHP functions that are forbidden. The whole PHP block of code will not be executed if it contains any of these functions. |
| Forbidden (HTML) Tags | A comma separated list of tags that are forbidden. These tags will be stripped, and also any code in between double tags. |
These settings have effect on Articles and Categories. The security settings only have effect on articles.
| Enable in articles | Select whether to enable the use of the syntax in articles. |
| Security Level | Set the level of security. Sourcerer tags will be stripped from articles where the an owner (creator) is not a member of these groups. |
| Allow CSS tags | If enabled, CSS (style & link) tags are permitted within the Sourcerer tags. Otherwise the CSS tags (and the CSS code within) will be stripped. |
| CSS Security Level | Set the level of security. CSS tags (and the CSS code within) will be stripped from articles with an owner (creator) below this group level. If the overall security level is set higher, it will overrule this. |
| Allow JavaScript tags | If enabled, JavaScript (script) tags are permitted within the Sourcerer tags. Otherwise the JavaScript tags (and the JavaScript code within) will be stripped. |
| JavaScript Security Level | Set the level of security. JavaScript tags (and the JavaScript code within) will be stripped from articles with an owner (creator) below this group level. If the overall security level is set higher, it will overrule this. |
| Allow PHP tags | If enabled, PHP tags are permitted within the Sourcerer tags. Otherwise the PHP tags (and the PHP code within) will be stripped. |
| PHP Security Level | Set the level of security. PHP tags (and the PHP code within) will be stripped from articles with an owner (creator) below this group level. If the overall security level is set higher, it will overrule this. |
| Extra Forbidden PHP functions | A comma separated list of PHP functions to add to the forbidden list (see Default settings) |
| Extra Forbidden (HTML) Tags | A comma separated list of tags to add to the forbidden list (see Default settings) |
These settings have effect on the component area.
You can select in which components Sourcerer should not be enabled. Advise is to not allow Sourcerer in components that non-backend users can post content in.
| Enable in components | Select whether to enable the use of the syntax in components. |
| Disable on components | Select which components NOT to enable Sourcerer in. This is a list of your installed frontend components. |
| Allow CSS tags | If enabled, CSS (style & link) tags are permitted within the Sourcerer tags. Otherwise the CSS tags (and the CSS code within) will be stripped. |
| Allow JavaScript tags | If enabled, JavaScript (script) tags are permitted within the Sourcerer tags. Otherwise the JavaScript tags (and the JavaScript code within) will be stripped. |
| Allow PHP tags | If enabled, PHP tags are permitted within the Sourcerer tags. Otherwise the PHP tags (and the PHP code within) will be stripped. |
| Extra Forbidden PHP functions | A comma separated list of PHP functions to add to the forbidden list (see Default settings) |
| Extra Forbidden (HTML) Tags | A comma separated list of tags to add to the forbidden list (see Default settings) |
These settings have effect on the areas outside the component area (so in Modules and the rest of the website).
| Enable other areas | Select whether to enable the use of the syntax in all remaining areas, like the modules and the document head. |
| Allow CSS tags | If enabled, CSS (style & link) tags are permitted within the Sourcerer tags. Otherwise the CSS tags (and the CSS code within) will be stripped. |
| Allow JavaScript tags | If enabled, JavaScript (script) tags are permitted within the Sourcerer tags. Otherwise the JavaScript tags (and the JavaScript code within) will be stripped. |
| Allow PHP tags | If enabled, PHP tags are permitted within the Sourcerer tags. Otherwise the PHP tags (and the PHP code within) will be stripped. |
| Extra Forbidden PHP functions | A comma separated list of PHP functions to add to the forbidden list (see Default settings) |
| Extra Forbidden (HTML) Tags | A comma separated list of tags to add to the forbidden list (see Default settings) |
| Button Text | This text will be shown in the Editor Button. |
| Enable in frontend | If enabled, it will also be available in the frontend. |
| Sourcerer tag word | This defines the word to use as the Sourcerer syntax tag.
Default is 'source'. Which means the tags to use are: {source}...{/source} |
| Tag Characters | The surrounding characters of the tag syntax.
Note: If you change this, all existing tags will not work anymore.
Options: {...}, [...], {{...}}, [[...]], [:...:], [%...%] |
| Strip Surrounding Tags | Select to always remove html tags (div, p, span) surrounding the plugin tag. If switched off, the plugin will try to remove tags that break the html structure (like p inside p tags). |
| Enable in Head | Select to also handle the Sourcerer tags inside the document head section of the page. If unselected, any Sourcerer tags found in the head will get removed (together with any code inside them). |
| Remove from search | Select to remove the Sourcerer tags and content from the search results. |
| Include Path | The path (relative to the root folder) to use when including PHP files with the php attribute in the tag. |
| Path to Temp Folder | Please specify a writable folder to store temporary files. Leave empty to use the Joomla global Temp Folder |
| Place HTML comments | By default HTML comments are placed around the output of this extension.
These comments can help you troubleshoot when you don't get the output you expect.
If you prefer to not have these comments in your HTML output, turn this option off. |