en

This is the “JavaScript Inserter PRO” plugin instructions page. We have tried our best to keep it as simple as possible. If you think it can be made even simpler let us know we will be glad to change it. Let’s start!

On the left side, you can see the table of contents of this documentation. Jump to the section you want, or read it all through – your choice. Let’s move on!

Purchase process

To start using the “JavaScript Inserter PRO” plugin, you need to make a purchase on the official page of this plugin. To do this, select a license suitable for your case and make a payment. After the successful completion of the purchase, you will receive an email receipt with a button through which you can download a copy of the “JavaScript Inserter PRO” plugin.

Secure payment and delivery of the “JavaScript Inserter PRO” plugin is done using the Gumroad platform.

Installation

Install “JavaScript Inserter PRO” plugin just as you would any other WordPress plugin.

There are two methods to install the plugin. You can install it directly from the WordPress Admin Area, or you can install it manually by first downloading the plugin.

Automatic installation (via WordPress Admin Area):

To install the plugin automatically (from the WordPress Admin Area), please perform the following steps:

  1. Download the ZIP archive with this plugin to your computer. After downloading you should have a ZIP archive called javascript-inserter-pro.1.0.zip. This is a compressed file containing all the folders and files required for the plugin to function properly.
  2. Log in to Admin Area of your WordPress website.
  3. Go to Plugins -> Add New.
  4. Click Upload Plugin, and browse the ZIP archive with the plugin. Click the Install Now button. Wait a few seconds until the plugin is installed.
  5. Activate the plugin through the Plugins tab.

After installation and activation, the JS Inserter PRO menu item will appear in the Settings section of Admin Area. Click on it in order to view the plugin settings page.

Manual installation (via FTP access)

To install the plugin manually (by simply uploading all files via FTP or SFTP), please perform the following steps:

  1. Download the ZIP archive with this plugin to your computer. After downloading you should have a ZIP archive called javascript-inserter-pro.1.0.zip. This is a compressed file containing all the folders and files required for the plugin to function properly.
  2. Unzip the ZIP archive with this plugin on your computer. You’ll get the folder javascript-inserter-pro.

    You need to preserve the directory structure in the archive when extracting these files.

  3. Access your server via FTP or SFTP.

    If you aren’t sure how usually your web hosting provider will have instructions somewhere on their website.

  4. Browse to the directory wp-content/plugins/.

    The location of the folder wp-content depends on your host’s setup. Typically, the folder public_html contains all the files of the website, among which you will find this folder. Please contact your web hosting company to get help if you can’t find this folder.

  5. Upload the plugin folder javascript-inserter-pro from step 1. Wait for the uploading to complete, it may take several minutes. Once the upload complete, the plugin should be in wp-content/plugins/javascript-inserter-pro/ on your server.
  6. Log in to Admin Area of your WordPress website.
  7. Activate the plugin through the Plugins tab.

After installation and activation, the JS Inserter PRO menu item will appear in the Settings section of Admin Area. Click on it in order to view the plugin settings page.

More help installing plugins

Update plugin to new release

The “JavaScript Inserter PRO” plugin can be updated to new release just as you would any other premium WordPress plugin.

We have three types of updates:

  • Adding new features - We add new features to the plugin whenever we have a new cool feature requests by our customers, as well as our team.
  • Code improvement - This makes the plugin more stable and faster, and also improves security.
  • Solving bugs or issues - If any bugs or issues appear due to browser updates or WordPress version changes, we make sure to update the plugin ASAP to keep you and visitors of your website safe.

Regardless of the type of updates, they should be applied as soon as conveniently possible.

In one of the upcoming updates, we plan to implement an automatic plugin update system so that you no longer have to install updates manually.

Update via FTP or SFTP:

To update the plugin manually (by simply overriding all files via FTP or SFTP), please perform the following steps:

  1. Log in to Admin Area of your WordPress website.
  2. Deactivate this plugin through the Plugins tab.
  3. Download the ZIP archive with the new version of this plugin to your computer. After downloading you should have a ZIP archive called javascript-inserter-pro.1.0.zip. This is a compressed file containing all the folders and files required for the plugin to function properly.
  4. Unzip the ZIP archive with the new version of this plugin on your computer. You’ll get the folder javascript-inserter-pro.

    You need to preserve the directory structure in the archive when extracting these files.

  5. Access your server via FTP or SFTP.

    If you aren’t sure how usually your web hosting provider will have instructions somewhere on their website.

  6. Browse to the directory wp-content/plugins/.

    The location of the folder wp-content depends on your host’s setup. Typically, the folder public_html contains all the files of the website, among which you will find this folder. Please contact your web hosting company to get help if you can’t find this folder.

  7. It’s best to have a backup, so download the plugin folder javascript-inserter-pro to your computer.
  8. Upload the plugin folder javascript-inserter-pro from step 4, with replacing the current folder of the plugin. Wait for the uploading to complete, it may take several minutes. Once the upload complete, the plugin should be in wp-content/plugins/javascript-inserter-pro/ on your server.

    Important! Sometimes files are deleted inside the plugin folder so make sure that your program is deleting all files and uploading the new ones when it overrides instead of simply “updating newer files”. It can cause issues if you have files on your server inside the plugin folder that are no longer used in the plugin itself.

  9. Activate this plugin through the Plugins tab.

Note! After you are done updating a plugin please also clear your website and browser cache to prevent errors (this should be done when updating any theme or plugin).

License Key

You will receive a license key along with your purchase confirmation. As long as it is active, this key allows you to get updates for the purchased WordPress plugin and get access to premium support.

To enter your license key into the plugin, please perform the following steps:

  1. Log in to Admin Area of your WordPress website.

  2. Go to Settings -> JS Inserter PRO. You will be taken to the plugin settings page.

  3. Navigate to the License tab.

  4. Enter your license key in the field License Key.
  5. Click the Submit License Key button.

Using at first time

To use this plugin at first time, follow these steps:

  1. Log in to Admin Area of your WordPress website.

  2. Go to Settings -> JS Inserter PRO. You will be taken to the plugin settings page.

  3. Enter a title or a small description for the new snippet.

  4. Place your custom JavaScript code in the field bellow.

  5. Click the Save changes button.

Now your new snippet added and waiting when you enable it!

Add new snippet

You can easily add new snippet by following these steps:

  1. Click the Add another snippet button. New snippet will appear.

  2. Enter the name or small description for your snippet in the field Title or small description.

  3. Place your custom JavaScript code in the field bellow.

  4. Click the Save changes button.

Now your new snippet added and waiting when you enable it!

You can add unlimited number of new snippets. This is very useful, because that way you can manage your snippets separately. Just use a clear names for your snippets and you’ll always be know about what snippets and is responsible for what.

Enable or disable snippet

To enable or disable a snippet, follow these steps:

  1. Find the snippet that you want to enable or disable.
  2. Switch the toggle to the ON (green color) or OFF (red color) position.

  3. Click the Save changes button.

Edit snippet

To edit the code of a snippet, follow these steps:

  1. Find the snippet that you want to edit.
  2. Click the Pencil button in the upper-right corner of this snippet. The snippet editor panel opens.

  3. Edit the code of the snippet.

  4. Click the Save changes button.

Configure snippet

By default, all snippets are loaded on every front page, and placed at the beginning of the HEAD section. But you have the ability to manage this. To configure the snippet, follow these steps:

  1. Find the snippet that you want to configure.
  2. Click the Cog button in the upper-right corner of this snippet. The snippet settings panel opens.

  3. Select the desired settings.

  4. Click the Save changes button.

Delete snippet

You can easily delete any snippet by following these steps:

  1. Find the snippet that you want to delete.
  2. Click the Trash button on the right side of the snippet panel.

  3. You will be prompted to confirm the deletion. Click the OK button. This snippet will disappear, but not deleted yet.

  4. Click the Save changes button.

Done, the snippet is now deleted.

Backups of snippets

Each time you push the Save changes button this plugin creates a new backup of your snippets. This backup is a typical TXT file with all your snippets, like this:

/* Name:     My snippet 1
 * Enabled:  YES
 * Location: HEAD
 * Priority: BOTTOM
 * Load on:  BACKEND
 ------------------------- */
 // Wait for DOM to load
 document.addEventListener("DOMContentLoaded", function(event) {
     var e = document.getElementById("go");
     e.addEventListener("click", function() {
         document.getElementById("demo").innerHTML = "Hello World!";
     }, false);

 });


/* Name:     My snippet 2
 * Enabled:  NO
 * Location: FOOTER
 * Priority: TOP
 * Load on:  FRONTEND
 ------------------------- */
 // Wait for DOM to load
 document.addEventListener("DOMContentLoaded", function(event) {
     var e = document.getElementById("go");
     e.addEventListener("click", function() {
         document.getElementById("demo").innerHTML = "Hello World!";
     }, false);

 });

The file is given the name of the corresponding date of the creation and placed in the catalog backups. Also, for usability, creates a copy of the last backup and it’s named backup-last. You can download this file (backup-last.txt) directly from the plugin settings page.

Over time, it can accumulate a lot of backup files, so you may want to remove unnecessary files. To do this just go to the catalog backups (/wp-content/plugins/javascript-inserter-pro/backups/) and remove unnecessary (or all) files.

Customize code editor

This plugin uses the code editor powered by CodeMirror. This code editor has options such as syntax highlighting, line numbering, and more. In addition, you can easily customize it by simply selecting the desired settings. And if you want more options, let us know and we will be happy to add them.

To customize the code editor, follow these steps:

  1. Go to the “Settings” tab.

  2. Select the desired settings.

  3. Click the Save changes button.

The sidebar, which is located on the “Settings” tab, consists of several sections. It gives you quick access to the documentation of the plugin, and also you can download the latest backup of your snippets. We plan to add some more useful features here soon.

More help & support

If you have any questions that are beyond the scope of this documentation, please read the Frequently Asked Questions. If you still can’t find an answer to your enquiry, please don’t hesitate to contact us and we’ll be happy to help you out.