Joomla rating: 100%

Sourcerer

Place any code in Joomla!

Version: 4.4.9   Type: PS PB   Compatibility: Joomla! 2 Joomla! 3

Joomla rating: 100%

Do you like Sourcerer?

Rate it!

Description

Sourcerer enables you to place PHP and any kind of HTML style code (including CSS and JavaScript) right into your content! Not only in your articles, but also in sections, categories, modules, components, META tags, etc.

You can now just place your original codes right into your WYSIWYG editor. The only thing you have to do is surround the code with the Sourcerer tags. Easy peasy!

So now you can also use PHP scripts in your content. That opens up a great deal of possibilities.

Most Joomla! Text Editors will strip parts of your HTML code, like JavaScripts (think of statistics scripts) and movie embed tags. With Sourcerer you won't have these limitations.

Free vs Pro

Free

Free

Enough functionality for most websites!

Unlimited access to free updates and support.

Features

  • Place HTML
  • Place CSS
  • Place Javascript
  • Place PHP
  • Easy to use Sourcerer Code Editor (via Editor Button)
  • Basic security settings
    • Ability to set whether Sourcerer should be able to place CSS, JavaScript and PHP code

Free support

  • Access to Free forum
    • Get support for the extension.
      Response time aim: within 72 hours. Usually within 24 hours.
  • Install on multiple domains
    • You can install the extension on any domain you want. No limitations. No domain checks.
  • Open Source code
    • The code is open source (GPL), meaning there is no form of code encryption. No use of Zend Guard or ionCube.

Professional

 25

Need more? Get all Pro features and support.

1 year access to Pro updates and support.

Pro features

  • All features available in the free version, plus:
  • Use custom example code
    • Ability to change the default example code the Sourcerer Code Editor uses
  • Advanced security settings
    • Ability to set security levels on article, component and other area levels

Pro support

  • Access to Pro forum
    • Get faster support for the extension.
      Response time aim: within 48 hours. Usually within 12 hours.
  • Pro downloads & updates
    • Get access to the Pro downloads and updates for a full year.
  • Install on multiple domains
    • You can install the extension on any domain you want. No limitations. No domain checks.
  • 30 Day money back guarantee
    • Not happy with the extension? Or simply have no use for it after trying out the Pro version? Simply ask your money back!
  • Open Source code
    • The code is open source (GPL), meaning there is no form of code encryption. No use of Zend Guard or ionCube.

Bundle offer

Get ALL NoNumber Pro extensions worth 375

And save 60%

1 year access to Pro updates and support.

 150 Buy a Bundle

Lifetime Bundle

Get LIFETIME access to ALL NoNumber Pro extensions.

And save loads

LIFETIME access to Pro updates and support.

 500 Buy a Lifetime Bundle

Tutorial

There is a Free and a Pro version of Sourcerer.
The parts in this tutorial that only concern the Pro version will be marked with: Pro only

Introduction

Sourcerer is a Joomla! system plugin (and editor button plugin).

Sourcerer enables you to place PHP and any kind of HTML style code (including CSS and JavaScript) right into your content! Not only in your articles, but also in sections, categories, modules, components, META tags, etc.

You can now just place your original codes right into your WYSIWYG editor. The only thing you have to do is surround the code with the Sourcerer tags. Easy peasy!

So now you can also use PHP scripts in your content. That opens up a great deal of possibilities.

Most Joomla! Text Editors will strip parts of your HTML code, like JavaScripts (think of statistics scripts) and movie embed tags. With Sourcerer you won't have these limitations.

Syntax

The syntax is pretty simple. Just place {source} and {/source} tags in text area you want the code to appear (like an article or Custom HTML module), and place your code between the tags.

You can use the Sourcerer editor button to make this even easier.

You should place the code in your WYSIWYG editor, and NOT in the HTML view of the editor.

Using the double bracket syntax

Some editors (i.e. TinyMCE) will strip html style tags when you enter them in the WYSIWYG view. For that reason you can also use double square brackets for the HTML style tags. So if your tags get stripped, use the double bracket syntax.

For instance, instead of doing this:

{source}<strong>Text</strong>{/source}

Use this syntax:

{source}[[strong]]Text[[/strong]]{/source}

PS: The Sourcerer editor button will help you convert code to double bracket syntax (or back to normal tags).

Using HTML entities

When you want to use html entities in your code, you will notice that most editors will convert them to actual characters when saving.

You can prevent that from happening by using an underscore to escape it, like:

{source}Dani&_euml;lle{/source}

Not using a WYSIWYG editor?

Sourcerer is designed to be used with a WYSIWYG editor. It will strip all tags in the html of the content, to prevent styling from messing with the code.

When you do not use a WYSIWYG editor (or the field you want to enter code in has no editor), practically all code will be stripped, which you don't want of course.

To disable Sourcerer from stripping the html code, you can use the '0' parameter in the {source} tag, like:

{source 0}code in an html editor{/source}

PS: You don't have to add this 0 to the tag when using {source} tags in the replace fields of ReReplacer. ReReplacer is smart enough to pass the code onto Sourcerer in the {source 0} way.

Examples

Here are some simple examples of how to place code.

HTML tags

Code

{source}<span style="color:red">This text should be red!</span>{/source}

Result

This text should be red!

HTML tags (with double square brackets)

If your editor has problems saving tags entered in the WYSIWYG view, and strips these upon saving, then you can use the double bracket syntax for tags.
So [[tag]] instead of <tag>.

Code

{source}[[span style="color:red"]]This text should be red![[/span]]{/source}

Result

This text should be red!

JavaScript

Code

{source}
<script type="text/javascript">
    document.write('This text is placed through <strong>JavaScript</strong>!');
</script>
{/source}

Result

PHP

Code

{source}
<?php
    echo 'This text is placed through <strong>PHP</strong>!';
?>
{/source}

Result

This text is placed through PHP

Combined (HTML, JavaScript and PHP)

Code

{source}
<span style="color:red">This text should be red!</span>
<br />
<script type="text/javascript">
    document.write('This text is placed through <strong>JavaScript</strong>!');
</script>
<?php
    echo '<p>';
    echo 'This text is placed through <strong>PHP</strong>!';
    echo '</p>';
?>
{/source}

Result

This text should be red!

This text is placed through PHP

More examples

Find more examples and ways to implement certain code in the FAQs.

Editor Button

You can enter the tags directly into your content. However, to save time typing and remembering what the exact syntax is, Sourcerer comes with a handy editor button.

When clicking on this 'Insert Code' editor button (located below the text input area) you will get a modal popup with the Sourcerer code editor.
This code editor will display the example code, which you can change to meet your needs. After clicking on the 'Insert' button, that code will be placed back into your article/content editor.

I recommend you always use this editor button to insert code, as it prevents your content editor from messing up the code.

To edit code that is already in your article/content item, simply select the code - including the {source} tags, and click on the Sourcerer editor button. The selected code will appear in the Sourcerer editor. And after clicking on the 'Insert' button, the new code will replace the selected code.

You can customise the default tag and editor button settings in the Sourcerer system plugin settings.

Settings

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:

Tag Syntax

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}
Include Path The path (relative to the root folder) to use when using the file attribute in the tag.

Security Settings - Default

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. For more precise settings, see the Advanced Security settings.

CSS

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.

JavaScript

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.

PHP

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.

Security Settings - Articles Pro only

These settings have effect on Articles and Categories.
The security settings only have effect on articles.

Same settings as the 'Security Settings - Default', plus below settings

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.

CSS

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.

JavaScript

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.

PHP

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.

Security Settings - Components Pro only

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.

Same settings as the 'Security Settings - Default', plus below settings

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.

Security Settings - Other Areas Pro only

These settings have effect on the areas outside the component area (so in Modules and the rest of the website).

Same settings as the 'Security Settings - Default', plus below settings

Enable other areas Select whether to enable the use of the syntax in all remaining areas, like the modules and the document head.

Editor Button Options

Button Text This text will be shown in the Editor Button.
Enable in frontend If enabled, it will also be available in the frontend.

Defaults

These setting have effect on the initial settings when you open the Sourcerer Code Helper window.

Add {source} tags If selected, the code will be surrounded by {source} tags (if the tags are not already in the code).

Example Code

Use Example Code If enabled, the example code below will be placed inside the Sourcerer tags.
Example Code Here you can place the example code you want to be placed inside the Sourcerer tags. If you leave this field empty and save it, this field will be reset to the default example code.

Installation

You can either install Sourcerer by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful NoNumber Extension Manager.

Note: When updating Sourcerer, you do not need to uninstall it first. The package will update all the files automatically.

Keep in mind that when you update to a major new version (or uninstall first), you might lose some configuration settings.

NoNumber Extension Manager

It is very easy to install/update any NoNumber Extension using the NoNumber Extension Manager.

Please see the User Guide for the NoNumber Extension Manager for more detailed information...


Joomla! Extension Manager

To install via the Joomla! Extension Manager, just follow these steps:

  1. Log into your Joomla administrator;
  2. In the menu, choose: Extensions >> Extension Manager;
  3. Choose the tab: Install from Web (or enable it if you haven't done so yet);
  4. Select the search field and enter Sourcerer and hit enter;
  5. Click on the Sourcerer listing;
  6. Click on Install;
  7. Click on Install to confirm.
Joomla! Installer - Install from Web

Or if you need to install the Pro version or cannot install via the 'Install via Web' method for some reason:

  1. Download the extension install file (.zip);
  2. Log into your Joomla administrator;
  3. In the menu, choose: Extensions >> Extension Manager;
  4. Choose the tab: Upload Package File;
  5. Click on the Choose File button and select the extension zip;
  6. Click on Upload & Install.
Joomla! Installer - Upload Package File

If you have problems installing Sourcerer, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension

FAQs

The {source} tags are not being converted

The Sourcerer plugin is not published

Check if the Sourcerer plugin is published. Go to Extensions >> Plugin manager and search for the system plugin "System - NoNumber Sourcerer". Then publish it.

There is markup code in the Sourcerer syntax tags

Sourcerer has no problem with markup codes between the {source} tags. However, the {source} tags themselves will have to be free from markup. So this will make the {source} block from working:

<span>{</span>source}

Remove the extra styling or other html tags around and in the {source} tags that might cause problems.

Code is stripped when I save the article

Make sure you are using the WYSIWYG view of your editor.

Some editors remove tags you enter in the editor (even if not in html view).

To prevent tags from being stripped, use the double bracket syntax. So instead of <tag>, do [[tag]].

Some editors (like JCE) do allow you to enter tags in the WYSIWYG view, but you may have to change some settings in the editor.

Code is stripped on the frontend
(In the editor the code is all there)

The security level prevents the use of Sourcerer

You can set certain security settings in the Sourcerer plugin. This way you can prevent certain user group levels and certain content types to not allow the use of Sourcerer. Please look in the html output source of you site to see if you have a Sourcerer comment that tells you this is the case.

Using JavaScript or PHP in the tags?

Some editors remove tags you enter in the editor (even if not in html view).

To prevent tags from being stripped, use the double bracket syntax. So instead of <tag>, do [[tag]].

Some editors (like JCE) do allow you to enter tags in the WYSIWYG view, but you may have to change some settings in the editor.

JavaScript is not working

You have forgotten the script open- and close-tags

JavaScript should be placed inside the script tags:

<script type="text/javascript">...</script>

Or for double bracket syntax:

[[script type="text/javascript"]]...[[/script]]

The security level prevents the use of JavaScript

You can set certain security settings in the Sourcerer plugin. This way you can prevent certain user group levels and certain content types to not allow the use of JavaScript. Please look in the html output source of you site to see if you have a Sourcerer comment that tells you this is the case.

PHP is not working

You have forgotten the PHP open- and closetags

PHP should be placed inside the PHP tags

<?php ... ?>

Or for double bracket syntax:

[[?php ... ?]]

The security level prevents the use of PHP

You can set certain security settings in the Sourcerer plugin. This way you can prevent certain user group levels and certain content types to not allow the use of PHP. Please look in the html output source of you site to see if you have a Sourcerer comment that tells you this is the case.

There are errors in your PHP code

Sourcerer will not execute your PHP code if it has errors. You can check if you have errors by looking in the html output source of you site to see if you have a Sourcerer comment that tells you this is the case.

How to add CSS to the head of the html page

You can add css styles to the head of the html output using Joomla's built-in document functions.

Sourcerer already creates the $document (or $doc) object for you when it is needed. So you do not have to initialize this yourself.

To place a piece of 'inline' css code, use:

{source}<?php 
$css = "
body {
color: red;
}
";
$doc->addStyleDeclaration( $css );
?>{/source}

To add a css file to the head, use:

{source}<?php
$doc->addStyleSheet( JURI::root( true ).'/path/to/your/file.css' );
?>{/source}

To add multiple stylesheets and javascripts, you can place 1 php block like:

{source}<?php
   $css = "
      body {
         color: red;
      }
   ";
   $doc->addStyleDeclaration( $css );
   $doc->addStyleSheet( JURI::root( true ).'/path/to/your/file.css' ); 
   $doc->addStyleSheet( JURI::root( true ).'/path/to/your/file2.css' );
   $script = "
      alert('this is javasript');
   ";
   $doc->addScriptDeclaration( $script );
   $doc->addScript( JURI::root( true ).'/path/to/your/file.js' ); 
   $doc->addScript( JURI::root( true ).'/path/to/your/file2.js' ); 
?>{/source}

PS: When you use the $document or $doc in (custom HTML) modules, remember to switch on the Prepare content option.

How to add Javascript to the head of the html page

You can add Javascript code or files to the head of the html output using Joomla's built-in document functions.

Sourcerer already creates the $document (or $doc) object for you when it is needed. So you do not have to initialize this yourself.

To place a piece of 'inline' Javascript code, use:

{source}<?php 
$script = "
alert('this is javasript');
";
$doc->addScriptDeclaration( $script );
?>{/source}

To add a js file to the head, use:

{source}<?php
$doc->addScript( JURI::root( true ).'/path/to/your/file.js' );
?>{/source}

To add multiple stylesheets and javascripts, you can place 1 php block like:

{source}<?php
   $css = "
      body {
         color: red;
      }
   ";
   $doc->addStyleDeclaration( $css );
   $doc->addStyleSheet( JURI::root( true ).'/path/to/your/file.css' ); 
   $doc->addStyleSheet( JURI::root( true ).'/path/to/your/file2.css' );
   $script = "
      alert('this is javasript');
   ";
   $doc->addScriptDeclaration( $script );
   $doc->addScript( JURI::root( true ).'/path/to/your/file.js' ); 
   $doc->addScript( JURI::root( true ).'/path/to/your/file2.js' ); 
?>{/source}

PS: When you use the $document or $doc in (custom HTML) modules, remember to switch on the Prepare content option.

How to include a file

Including a php file

When using large pieces of php code, or you want to reuse the same piece of code in multiple places. it is wise to put this code in a separate php file.
Then you can simply include the file with a single line through Sourcerer.

Example PHP file:
www.yourdomain.com/myfiles/file.php

{source file=myfiles/file.php}{/source}

You can also place php inside the tags. For instance, if you set variables inside the php file, you can use/manipulate them further in the php block:

{source file=myfiles/file.php}<?php
   echo '<div class="mydiv">' . $var_from_file . '</div>';
?>{/source}

This will simply include the file. If you have a php file with classes and functions in it, you will get issues when including the file more than once. In that case it is better to use php to only make in include/require the file once:

{source}<?php
require_once JPATH_SITE.'/myfiles/file.php';
?>{/source}

include/require vs require_once

You can also use 'include' (or 'require') instead of 'require_once', but only use that if you need the file included more than once on your page.
If your php file creates classes / functions, having it included more than once will cause errors like "Cannot redeclare class".

Setting variables for a php file

If you want to set variables that are used in the php file, you can simply set them before the require/include, like:

{source}<?php
$name = 'Peter';
$surname = 'van Westen';
$interests = array( 'small fluffy things', 'green cantaloupe', 'toothpaste', '9V batteries' );
require_once JPATH_SITE.'/myfiles/file.php';
?>{/source}

Including a text or html file

For text files, like .txt or .html you could use this syntax:

{source}<?php
echo file_get_contents( JPATH_SITE.'/myfiles/file.txt' );
?>{/source}

NO html structures

Please keep in mind that files you include SHOULD NOT generate their own html structure (<html>, <head>, <body> tags).
If you include a file, it will be placed inside your Joomla content, which is already inside a full html structure.

So if you want to load in html files, make sure they only contain the text part (what is inside the <body>).
If you include a php file, it should also not output any of these main html structure parts.

Otherwise you will either have to use iframes or use some more advanced php code to strip the html structure away.

Also see: What to do with <head> or <body> tags?

What to do with <head> or <body> tags?

You SHOULD NOT add any main html structure tags (<html>, <head>, <body> tags) inside your content.
Joomla already creates the full html structure. So if you place structure tags in your content, you will get invalid html, which can cause all sorts of issues.

When copying code from some ready-made html/script, make sure you only place the part that is inside the <body> tags into your content.

If you need to add css or javascript to the head of your page, you can do so via PHP. See:

How to connect to the database

If you want to do database calls to get data from it (or write data to it), you can use Joomla's built-in database object and functions.

Sourcerer already creates the $database (or $db) object for you when it is needed. So you do not have to initialize this yourself.

So for example, you can directly do:

{source}<?php
$query = "SELECT something from #__mydatabasetable WHERE this = 'that'";
$database->setQuery($query);
$result = $database->loadResult();
?>{/source}

Or, using the new syntax (Joomla 2.5+):

{source}<?php
$query = $db->getQuery(true);
$query->select($db->nameQuote('something'));
$query->from('#__mydatabasetable');
$query->where($db->nameQuote('this').' = '.$db->quote('that'));
$db->setQuery($query);
$result = $database->loadResult();
?>{/source}

For more information on how to use the Joomla Database object: docs.joomla.org/How_to_use_the_database_classes_in_your_script

How to connect to an external database

{source}<?php
$option = array();
$option['driver'] = 'mysql'; // Database driver name
$option['host'] = 'db.myhost.com'; // Database host name
$option['user'] = 'fredbloggs'; // User for database authentication
$option['password'] = 's9(39s£h[%dkFd'; // Password for database authentication
$option['database'] = 'bigdatabase'; // Database name
$option['prefix'] = 'abc_'; // Database prefix (may be empty)

$db = JDatabase::getInstance( $option );
?>{/source}

For more information on how to use the Joomla Database object: docs.joomla.org/How_to_use_the_database_classes_in_your_script

What variables & objects does Sourcerer have ready for use

Sourcerer checks your php code to see if you are referencing any commonly used Joomla objects / variables, and then creates them for you.

This means you don't have to create these variables yourself every time.

Currently Sourcerer creates these variables ready for use:

  • $mainframe or $app
  • $document or $doc (Cannot be used in Sourcerer code in modules)
  • $database or $db
  • $user The user object containing the details of the guest or current logged in user
  • $Itemid The menu id of the page
  • $article The article object (Only available when using the code inside articles)

Quotes are escaped (\") in the editor

This is caused by an incorrect server setting. The Magic Quotes GPC php settings should be switched off. If you don't know how to change that setting, ask your host.

I get a 'Parse' error / 'runtime-created function' error

This means something is wrong with the php code you have placed through Sourcerer.
Double check your own code for problems.

I want to prevent others from using the {source} tag

The easiest way to prevent this is to change the tag syntax name to something other than 'source'. You can change this in the Sourcerer system plugin settings.

For instance, if you change this to 'mycode', then the {source} tags no longer work and you have to use {mycode}...{/mycode}

In the Pro version you have extensive security settings to (dis)allow certain things for different user groups. So you can fine-tune the ability to use the Sourcerer tags and types of code.

Installation

How can I install/upgrade Sourcerer?

You can either install Sourcerer by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful NoNumber Extension Manager.

Note: When updating Sourcerer, you do not need to uninstall it first. The package will update all the files automatically.

Keep in mind that when you update to a major new version (or uninstall first), you might lose some configuration settings.


Sourcerer won't install...

If you have problems installing Sourcerer, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension

How can I uninstall Sourcerer?

You can either uninstall Sourcerer by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful NoNumber Extension Manager.

If you no longer use any NoNumber extensions, you can also uninstall the NoNumber Framework plugin by using the Joomla! core extension manager.

What are the minimum requirements?

Sourcerer will only work correctly if your setup meets these requirements:

  • Up-to-date version of Joomla:
    • Joomla 2.5.10 or higher
    • Joomla 3.3.0 or higher
  • PHP 5.3.13 or higher
  • PHP mbstring (Multibyte String) functions enabled
  • MySQL 5 or higher

Important: I can only provide support for setups that:

  • meet the above requirements;
  • do not have extension files or Joomla! core files which have been altered in any way.

Where can I download earlier versions?

You have access to all previous free versions of all extensions on this website.

If you have a subscription to an extension, you can also download any previous pro version of any extension on this website.

If you do not have a valid subscription, you can download any pro version that is older than 1 year.

You can find old versions in the changelog.

Note: Please note that I am unable to provide support on old versions! (whether you have a subscription or not).

How can I downgrade to an earlier version of Sourcerer?

If for some reason you need to install an older version, it is best to uninstall the extension first.

You will also have to uninstall the NoNumber Framework system plugin.

After that you can simply install the older version zip file using the Joomla! installer.

Note: Please note that I am unable to provide support on old versions!

How can I upgrade from Joomla 2.5 to Joomla 3?

The upgrade of Joomla itself is a one-click process. But that just takes care of Joomla.

Many templates and extensions will not work the same or at all after upgrading to Joomla 3.

I personally advise against using the built-in upgrade process, and advise starting from scratch by installing a fresh copy of Joomla 3.

If you do want to upgrade Joomla 2.5 to Joomla 3, you will need to do this with regards to the NoNumber extensions you have installed:

  1. Disable or uninstall all NoNumber extensions.
    (Uninstalling NoNumber extensions will make you lose any global configuration settings for that extension. You will not lose any saved items)
  2. Upgrade Joomla 2.5 to Joomla 3.
  3. Re-install all NoNumber extensions you want installed.

For a detailed step-by-step migration process, see: https://docs.joomla.org/Joomla_2.5_to_3.x_Step_by_Step_Migration

Licensing

Under what license are NoNumber extensions released?

All free and paid NoNumber extensions are released under the Open Source GNU GPL v2.0 license.

See the Terms & Conditions for additional terms.

NoNumber Framework

What is the NoNumber Framework?

The NoNumber Framework is a Joomla! system plugin that is installed along with every NoNumber extension.

This plugin contains all the common functions and language strings that the NoNumber extensions use.

If you use any NoNumber extensions, this plugin must be installed and published. They will not function correctly or they will not function at all without it.

What is the NoNumber Elements plugin?

The NoNumber Elements system plugin is no longer used and has been replaced by the NoNumber Framework.

If you have been using NoNumber extensions for a long time you may still have this Elements plugin installed.

The NoNumber Elements plugin can safely be uninstalled IF your NoNumber extensions are up-to-date.

More Questions

I cannot find an answer to my question

Is there no answer to your question in this list, please try out these options:

  • General FAQs
    For general questions see the Pre-Sale Questions & Answers.
  • Tooltips
    All settings/options for the installed extensions have tooltips that explain what that setting is for. That should give you enough information to know how to use it.
  • Google
    Google is your friend! If you have some problem, get an error, have a question, try out Google. It usually gives you enough feedback to find an answer.
  • Forum
    For more specific questions or feedback, please use the Forum.

Changelog

+ Added   - Removed   ^ Changed   # Fixed

25-Feb-2015 : v4.4.9

Download Free

 ^ Updated translations: uk-UA
 ^ PRO Fixed issue with components select list only saving one value

08-Jan-2015 : v4.4.8

Download Free

 ! Removed compatibility for php versions under 5.3.13
 ! J3 Removed compatibility for Joomla 3 versions under 3.3.0
 ^ Updated translations: pl-PL, pt-PT, tr-TR
 # Fixed issue with Free version being able to be installed over the Pro version

25-Nov-2014 : v4.4.7

Download Free

 ^ Cleans left over {source} tags from head part possibly placed there by other extensions
 # Fixed issue with error about nnFile on installation on some setups
 # Fixed issues with whitespace being stripped from html between php blocks
 # PRO Fixed issues with duplicate rows in update_sites table

28-Oct-2014 : v4.4.6

Download Free

 # Fixed issue with plugin not working on jDownloads frontend view

02-Oct-2014 : v4.4.5

Download Free

 # Fixed issue with plugin not being run over introtext/fulltext on onContentPrepare event

10-Sep-2014 : v4.4.4

Download Free

 # Fixed issue with error about undefined object

10-Sep-2014 : v4.4.3

Download Free

 ^ Updated translations: id-ID, nl-NL
 # Fixed issue with {source} tags being stripped from frontend editor fields

11-Aug-2014 : v4.4.2

Download Free

 ^ Updated translations: lt-LT
 # J2.5 Fixed issue with editor button popup not working

10-Aug-2014 : v4.4.1

Download Free

 # Fixed issue with html potentially being interpreted as php (causing errors)

10-Aug-2014 : v4.4.0

Download Free

 + Added ability to include files simply via {source file=myfile.php}
 ! J3 Removed compatibility for Joomla 3 versions under 3.2.2
 ^ Refactored code
 ^ Updated translations: id-ID, pl-PL
 # Fixed issue with tags being converted in com_myjspace edit forms
 # J2 Fixed issue with errors after upgrade to Joomla 3
 # J3 Fixed issue with tags not being handled in search results

16-Apr-2014 : v4.3.3

Download Free

 + Added translations: id-ID
 ^ Cleaned up some code
 # Fixed issue with html structure issues when tags are directly inside html 5 elements
 # Fixed issue with some missing language strings in some occasions
 # J3.3 Fixed some Joomla 3.3 incompatibility issues

27-Feb-2014 : v4.3.2

Download Free Download Pro (older than 1 year)

 ^ Improved rendering speed on list views
 # Fixed issue with breaking of xml view of com_jmap
 # Fixed issue with feeds being broken
 # Fixed issue with some missing language strings in some occasions

30-Dec-2013 : v4.3.1

Download Free Download Pro (older than 1 year)

 # Fixed issue with tags being encoded in frontend edit views

19-Dec-2013 : v4.3.0

Download Free Download Pro (older than 1 year)

 ^ Improved some code in NoNumber Framework which improves page load speed
 ^ Updated translations: pt-PT
 # SECURITY FIX: Fixed issue with editor button popup window being accessible to all registered users

20-Nov-2013 : v4.2.7

Download Free Download Pro (older than 1 year)

 # J3.2 Fixed issue with quotes from Sourcerer editor being converted to html entities when inserted

18-Nov-2013 : v4.2.6

Download Free Download Pro (older than 1 year)

 # Fixed installation error about duplicate entry on some MySQL 5.6 setups
 # FREE Fixed issue with example code being messed up after saving plugin settings
 # J3 Fixed issue with code inserted incorrectly on Firefox (adding line numbers)

08-Nov-2013 : v4.2.5

Download Free Download Pro (older than 1 year)

 # J3.1 Fixed issue with modal popups not working

07-Nov-2013 : v4.2.4

Download Free Download Pro (older than 1 year)

 # J3 Fixed Joomla 3.2 compatibility issues

03-Nov-2013 : v4.2.3

Download Free Download Pro (older than 1 year)

 # Fixed issue with icons not working

01-Nov-2013 : v4.2.2

Download Free Download Pro (older than 1 year)

 + Added translations: es-ES, et-EE, uk-UA
 ^ Changed javascript minification to use Google Closure
 ^ Updated translations: de-DE, ja-JP, pl-PL, pt-PT
 # Fixed issue with header stuff (javascript/css) not always being added in category views

25-Sep-2013 : v4.2.1

Download Free Download Pro (older than 1 year)

 + Added translations: tr-TR
 # Fixed issue with opening tags not being converted on some setups
 # Fixed issue with tags sometimes appearing in title tags and title attributes
 # Fixed issue with warning message showing when item has unvalid user id as creator
 # J2 Improved rendering speed on list views

13-Aug-2013 : v4.2.0

Download Free Download Pro (older than 1 year)

 ! J2 Removed compatibility for Joomla 2.5 versions lower than 2.5.10
 ! J3.0 Removed compatibility for Joomla 3 versions lower than 3.1.0
 # J3.0 Improved rendering speed on list views
 # J3 Fixed issue with editor button not getting styled correctly on TinyMCE

19-Jun-2013 : v4.1.9

Download Free Download Pro (older than 1 year)

 # J3 Fixed issue with icons in the Sourcerer editor buttons not working correctly

13-Jun-2013 : v4.1.8

Download Free Download Pro (older than 1 year)

 ^ Improved minification of js files
 ^ J2 Converted images in (editor) buttons to font icons
 # Fixed issue with some language strings in comments not being converted

30-May-2013 : v4.1.7

Download Free Download Pro (older than 1 year)

 ^ J2 Minified the editor javascript
 # Fixed issue with article security settings being applied to modules that have content prepare enabled

22-Apr-2013 : v4.1.6

Download Free Download Pro (older than 1 year)

 # Fixed issue with installation manifest details not updating
 # Fixed issue with update manager not seeing latest version (caused by manifest)

18-Apr-2013 : v4.1.5

Download Free Download Pro (older than 1 year)

 ^ Updated translations: it-IT, ja-JP
 # J3 Fixed issue with & in selection being converted to & in Sourcerer editor

28-Mar-2013 : v4.1.4

Download Free Download Pro (older than 1 year)

 ^ Changed messaging on installation on unsupported Joomla versions
 ^ Cleaned up some code (syntax)

18-Mar-2013 : v4.1.3

Download Free Download Pro (older than 1 year)

 # Fixed issue with span tags around the {source 0} tag being removed

11-Mar-2013 : v4.1.2

Download Free Download Pro (older than 1 year)

 + Added less files for generating css files
 ! J2 Removed unused files from code editor
 ^ Minified css and js files
 ^ Updated translations: lt-LT
 # Fixed some issues with installation breaking and throwing errors on some setups

10-Jan-2013 : v4.1.1

Download Free Download Pro (older than 1 year)

 # J2 Fixed issue with editor button not having icon due to missing css file
 # J3 Fixed issue with editor button popup not working (javascript not being loaded)

30-Dec-2012 : v4.1.0

Download Free Download Pro (older than 1 year)

 ^ Cleaned up code
 ^ Moved media files to Joomla media folder
 ^ Updated translations: fr-FR
 # Fixed error about XML setup file on first install

11-Dec-2012 : v4.0.4

Download Free Download Pro (older than 1 year)

 # Fixed issue with php variables being set inside custom code not being gloabally available

11-Dec-2012 : v4.0.3

 ! Removed eval code and debugging options (is now left to php error handling)
 ^ Updated translations: zh-CN
 # J2 Fixed issue with errors about xml files on installation

14-Nov-2012 : v4.0.2

Download Free Download Pro (older than 1 year)

 + Added translations: zh-CN
 # Fixed issue with error messages about XML file on installation on some setups

10-Nov-2012 : v4.0.1

Download Free Download Pro (older than 1 year)

 # FREE Fixed issue with version number causing problems with version check in the NoNumber Extension Manager

09-Nov-2012 : v4.0.0

Download Free Download Pro (older than 1 year)

 + J3 Added Joomla 3 support
 ! J1.5 Removed Joomla 1.5 support

09-Nov-2012 : v3.3.0

Download Free Download Pro (older than 1 year)

 + FREE Added default indentation to Free version
 ! Removed option to preserve colors
 ! Removed option to switch of preserving indentation
 ! J1.5 LAST VERSION COMPATIBLE WITH JOOMLA 1.5

23-Oct-2012 : v3.2.2

Download Free Download Pro (older than 1 year)

 # Fixed issue with php code not working when there are nbsp entities in source
 # J2 Fixed issue with errors with Phoca PDF
 # J2 Fixed issue with inserted code into JCE editor not showing

20-Sep-2012 : v3.2.1

Download Free Download Pro (older than 1 year)

 ^ Updated translations: el-GR
 # Fixed issue with tags being handled in edit for of jcal, jevent and some others

29-Jun-2012 : v3.2.0

Download Free Download Pro (older than 1 year)

 + Added ready to use document/doc object variables
 + Added translations: sv-SE
 ! Removed ability to install on Joomla 1.6 and 1.7
 ! Removed ability to install on setups with php 5.2 or lower
 ^ Cleaned a lot of code
 # Fixed issue with tags being interpreted inside the Josetta form

01-May-2012 : v3.1.0

Download Free Download Pro (older than 1 year)

 + Added translations: zh-TW
 ^ Improved protecting of edit forms to only protect fields (so tags work outside form fields)
 ^ Increased page load speed by changing how xml files are loaded

12-Apr-2012 : v3.0.3

Download Free Download Pro (older than 1 year)

 # Fixed issue with language strings not being converted in editor button popup

11-Apr-2012 : v3.0.2

Download Free Download Pro (older than 1 year)

 # J1.5 Fixed issue with settings slides not working correctly

10-Apr-2012 : v3.0.1

Download Free Download Pro (older than 1 year)

 # SECURITY FIX: Fixed URL injection vulnerability in NoNumber Framework

07-Apr-2012 : v3.0.0

 ^ Changed some language strings
 ^ Cleaned up code syntax
 ^ Moved editor button settings to system plugin
 ^ Now available as Pro and Free version
 ^ Updated translations: de-DE
 # Fixed issue with forbidden php functions like exec also blocking functions like curl_exec

01-Mar-2012 : v2.11.4

 ^ Improved protection of editor fields
 ^ [J1.7+] Improved handling of tags in pdfs
 # Fixed issue with php 'non-object' error when there are users with ids lower than 30
 # [J1.7+] Fixed styling issues in Editor Button popup

13-Jan-2012 : v2.11.3

 + Added translations: bg-BG, pl-PL, pt-PT, th-TH
 ^ Cleaned up more code
 ^ Updated translations: de-DE
 # Fixed issue with installer not removing the folder/zip from the tmp
 # [J1.7+] Fixed issue with database error in editor button popup window

07-Nov-2011 : v2.11.2

 + Added translations: sl-SI
 ^ Cleaned code syntax (no longer guaranteed support for php 5.2.x and lower)
 # Fixed issue with tags being handled in some edit forms

17-Oct-2011 : v2.11.1

 ^ Updated translations: de-DE
 # Fixed security issue in NoNumber Framework plugin

08-Oct-2011 : v2.11.0

 ^ Changed NoNumber Elements plugin to NoNumber Framework
 ^ Cleaned up some code (like no more use of DS)
 ^ Improved installer
 ^ Moved common language strings to NoNumber Framework files
 ^ Moved translation language files to main package (no more language packs)
 # Fixed issue with installation problems on some Joomla 1.7 setups
 # J1.7 Fixed issue with Editor Button settings not being handled
 # J1.7 Fixed issue with Example Code field in Editor Button settings not working
 # J1.7 Fixed issue with php debugging not working

05-Jul-2011 : v2.9.0

 + Added option to set security levels for css, js and php to default
 + Joomla 1.7 compatible!

20-Jun-2011 : v2.8.5

 # J1.5 Fixed issue with installation problems

18-Jun-2011 : v2.8.4

 ^ Changed layout of settings
 ^ Changed use of elements
 ^ Changed way the mootools version is detected
 ^ Improved insertion of rich content in TinyMCE editor
 # Fixed issue with {source} tags being interpreted in frontend editor

01-Apr-2011 : v2.8.3

 # Fixed issue plugin being executed on raw format pages
 # Fixed issue with colors not being removed from source tags when inserting code

25-Mar-2011 : v2.8.2

 # Fixed issue with php error (get)

25-Mar-2011 : v2.8.1

 ^ Changed language files to be J1.6 ready
 # Fixed issue with editor button not working for registered/author level
 # Fixed issue with search component breaking in some cases
 # Fixed issue with tags being interpreted in frontend editor fields with very large contents

11-Feb-2011 : v2.8.0

 ^ Changed extension icon / logo
 # Fixed issue with public access to editor button popup page (security fix!)

14-Dec-2010 : v2.7.1

 # Cleaned up some code
 # Fixed issues with document being called to early
 # Fixed some issues with loading of language strings

25-Nov-2010 : v2.7.0

 + Added checks to see if NoNumber Elements plugin is installed/enabled
 ^ Fixed and updated all language strings
 ^ Improved code to make it lighter/faster
 # Fixed issue with tags being handled in edit fields

16-Nov-2010 : v2.6.0

 # Fixed extension causing pages to break on some setups
 # Fixed issue with not working in some forms (where they should)

15-Nov-2010 : v2.5.0

 ^ Made MooTools 1.2 compatible
 # Fixed issues with wrong version numbers in files
 # Fixed some missing language strings
 # Fixed some styling issues of PHP debug output

18-Oct-2010 : v2.4.10

 # Fixed faulty version number in package

18-Oct-2010 : v2.4.9

 # Fixed issue with language file not being loaded for comment strings in html output
 # Fixed issue with use of some special characters like à

24-Jul-2010 : v2.4.8

 ^ Changed way version and license information are displayed (now via ajax)
 ^ Changed way versions and licenses are checked (no more base64)
 # Fixed issue with plugin edit page give error due to missing file

19-Jul-2010 : v2.4.7

 # Fixed issue with usage of multiple php blocks without trailing semi-colon

07-Jul-2010 : v2.4.6

 ^ Improved some code to make it lighter
 # Fixed issue with errors in some cases when used in combination with Articles Anywhere

23-Jun-2010 : v2.4.5

 # Fixed issue with code looping, causing page timeouts

22-Jun-2010 : v2.4.4

 ^ Changed language strings used for comments
 ^ Improved code (=faster)
 # Fixed issue with enters before and after php output

02-Apr-2010 : v2.4.3

 ^ Made code a little lighter
 # Fixed issue with errors about registry for php 5.0.5
 # Fixed issue with errors on search page

09-Feb-2010 : v2.4.2

 ^ Reduced number of database queries
 # Fixed error on some articles when no author is set
 # Fixed issue with deprecated syntax for php 5.3+
 # Fixed issue with preg_match_all error in some cases (when article author is not set)

26-Jan-2010 : v2.4.1

 # Fixed issue with Missing argument errors in feeds
 # Fixed location of Joomla! DTD files

19-Jan-2010 : v2.4.0

 + Added Commercial License Code support
 ^ Added extra html to code helpers output to prevent editor stripping tags
 ^ Moved elements to separate global plugin (also used by other extensions)
 ^ Moved functions to helper file
 # Fixed issue with preservation of indentation on selection in IE
 # Fixed padding on editor button in fronted when no icon is shown

27-Nov-2009 : v2.3.2

 # Fixed issue with Sourcerer codes being handled in Joomfishplus edit page
 # Fixed issue with php errors when article does not pass security level

11-Nov-2009 : v2.3.1

 ^ Changed display of Sourcerer PHP Debugging
 # Fixed issue with PHP code breaking if last line is a comment

10-Nov-2009 : v2.3.0

 + Added option to define editor button text
 + Added option to show/hide editor button icon
 ^ Changed size of modal window for Sourcerer editor to maximum
 # Fixed issue with code from Sourcerer editor being messed up by html tags when using IE

28-Oct-2009 : v2.2.3

 ^ Changed file encoding to UTF-8
 ^ Changed method of indentation to output less html (1 tab image instead of 4 space images)
 ^ Changed output of code from Sourcerer editor when no color is kept (cleaner)
 # Fixed issue with wrong comment in html when PHP is not enabled or doesn't pass security

09-Oct-2009 : v2.2.2

 ^ Changed the update check
 # Fixed issue with changes in default settings not working

17-Sep-2009 : v2.2.0

 + Added option to preserve indentation of code in the content
 ^ Cleaned up some code
 ^ Completely change the editor button popup with special editor (EditArea)
 # Fixed issue with editor button popup not working on all setups
 # Fixed issue with errors when article author (created_by) does not exist

07-Aug-2009 : v2.1.8

 # Fixed issue with errors in feeds when using K2

05-Aug-2009 : v2.1.7

 ^ Made the toggling in settings faster and more stable
 # Fixed issue with textareas overlapping in settings (in IE)

01-Aug-2009 : v2.1.6

 # Fixed issue with html_entity_decode error on some setups (php4)

30-Jul-2009 : v2.1.5

 # Fixed issue with code styling tags not all being removed in final output

27-Jul-2009 : v2.1.4

 ^ Changed code to make the Sourcerer editor button window work faster/better
 # Fixed issue with Sourcerer editor button window not being accessible in some setups
 # Fixed issue with [SRC] tags sometimes showing
 # Fixed issue with code in Sourcerer editor button window not working properly in IE

17-Jul-2009 : v2.1.3

 # Fixed issue with error in Sourcerer editor button popup page

12-Jul-2009 : v2.1.2

 ^ Changed sliding toggle option (in admin settings) to work better in IE8
 # Fixed issues with php4 incompatibility

04-Jul-2009 : v2.1.1

 # Fixed issue with preg_replace error

03-Jul-2009 : v2.1.0

 + Added 3 ready available variables: $article, $user, $database
 + Added option to disable Sourcerer temporarily via url &disable_sourcerer=1
 ^ Changed the textarea element (made it resizable)
 ^ Made code a lot lighter (less memory load)
 ^ Moved frontend language to a separate file
 # Fixed issue with code in articles being executed twice
 # Fixed some comments not being placed correctly

26-Jun-2009 : v2.0.1

 + Added code coloring for html
 + Added fields to set the default rgb values for code coloring
 + Added syntax to escape html entities with underscore: &_...;
 ^ Changed auto installer
 ^ Changed the way the code is colored (more straightforward)
 # Fixed issue with special characters and &...; characters not being translated correctly

12-Jun-2009 : v2.0.0

 + Added a check to see if system plugin is installed in the editor button settings page
 + Added a lot of options to the editor button
 + Added a wizard
 + Added option to disable html cleanup with {source 0} tag
 ! Removed (the need for) the Sourcerer module and its settings
 ! Removed security check on article modifier (so now only checks creator)
 ! Removed the settings for Categories / Sections (is now together with Article settings)
 ! Removed update icon in administrator toolbar
 ^ Changed a lot of language code
 ^ Changed different administrator elements
 ^ Changed installation procedure (automatic installer/updater)
 ^ Changed tag syntax setting (can now only set word)
 ^ Changed the editor button from a simple insert to a complete Code Helper
 ^ Changed the link for more information
 ^ Changed the output of the PHP Debugging and enabled it only for (Super) Administrators
 ^ Changed the versioncheck
 ^ Changed the way PHP gets parsed: Now you can break PHP statements over multiple PHP blocks
 # Fixed issue with PHP vars over multiple Sourcerer tags
 # Fixed issue with editor button breaking if plugin was not installed
 # Fixed issue with editor button image not working on frontend
 # Fixed issue with editor button settings not working if plugin was disabled
 # Fixed issue with option to not use example code not working
 # Fixed issue with styling breaking the code (all html tags get stripped)
 # Fixed issue with using the {source} tags in paragraphs

26-Sep-2008 : v1.0.0

 + Added support for defining vars over multiple Sourcerer tags
 + First stable release
 ^ Changed a lot of code to standardize syntax
 ^ Changed the version check

03-Jul-2008 : v0.1.5

 # Fixed issue with params not being initialized properly (resulting in bug for components)

02-Jul-2008 : v0.1.4

 # Fixed an issue with special characters inside the Sourcerer tags

25-Jun-2008 : v0.1.3

 # Fixed a bug with the components compatibility

14-Jun-2008 : v0.1.2

 ^ Changed the bracket syntax for tags: now [[tag]] instead of [tag]. This because single brackets can be used in JavaScript and PHP.
 ^ Optimized the code a bit more

09-Jun-2008 : v0.1.1

 # Fixed some issues with security levels regarding articles

02-Jun-2008 : v0.1.0

 + First release (based on AnyTags! v2.2.2)
	
	

Reviews

Post a review

Functionality

couldn't be better write your own code, html, javascript, php include files and a lot more
Also save a lot of time

Ease of use

Very easy to install and use it takes u one minute to do all the work

Support

Best support ever Peter the developer of this extension is a very nice and kind guy, he answered my questions within a couple of hours

Documentation

PERFECT documentation

Ease of use

Functionality

Excellent!

Ease of use

Couldn't be simpler. I wish all extensions were this easy and intuitive.

Support

Have never needed it - Sourcerer is so easy to use I've never even needed the documentation.

Functionality

I feel very lucky for using this extension.
I just installed it and put my HTML code including CSS. PERFECT!!!

Support

all of the NoNumber extensions are great - but sourcerer knocks it out of the ballpark. Very powerful, super eassy to use, and the support is incredible.
This extension is perfect for integration of source code of Youtube or similar sites, works out of the box, Install and use, extreamly Easy and totally recommended for new or experimented users..
I have used Sourcerer along with ReReplacer for some days. It allows me to put user data (mails, phones) to articles form only user short name. I managed to use external MySQL db.

Both extensions together rock!!! And author response for questions is very quick and informative. Even for free versions.

Michal
Truly great piece of work. Extension works just great and more important - I don't think you will find such a great support team.
Thanks Peter!

See more reviews

Post a review

Reviews are taken from the Joomla Extensions Directory website.

Translations

Sourcerer comes packed with the following languages:

English (United Kingdom)
100%
Bulgarian (Bulgaria)
98%Translate
Catalan (Spain)
98%Translate
German (Germany)
100%
Greek (Greece)
100%
French (France)
98%Translate
Indonesian (Indonesia)
100%
Italian (Italy)
98%Translate
Japanese (Japan)
93%Translate
Lithuanian (Lithuania)
100%
Dutch (Netherlands)
100%
Polish (Poland)
100%
Portuguese (Brazil)
98%Translate
Portuguese (Portugal)
42%Translate
Russian (Russia)
98%Translate
Slovenian (Slovenia)
98%Translate
Swedish (Sweden)
98%Translate
Thai (Thailand)
98%Translate
Turkish (Turkey)
100%
Ukrainian (Ukraine)
100%
Chinese (China)
98%Translate
Chinese (Taiwan)
98%Translate

No language pack for your language?