It only takes one line of code on your website for InLinks to save you hundreds of hours on tasks that few web owners ever have time to carry out. Adding the code is the single most important step in the on-boarding process. This page talks about how to add the code and sets out to our strict policies on what we can and cannot do with the code

Note: The code verification should be immediate, but cannot check the javascript is displaying properly until you have associated a topic to at least one page. See “Have you made at least one Topic Association” in the troubleshooting section.

The short version

On registering, you will be given one line of code, which we recommend is placed in the footer section of your website, so that the line of code runs on any page that loads on your site. The script will look something like this:

<script defer=”” src=”https://jscloud.net/x/469/inlinks.js”></script>

This page covers

Reasons to add the code

The code helps InLinks to manage internal links on your site and add Schema to your web pages.

  • It does NOT collect any personal data (not even the IP numbers) of any users. You should not need to update any GDPR or privacy policies.
  • It will not create links OUT of your website. If (in the future) this is a requested feature, every out-link would be entered by the user.
  • It will NOT slow down your site. The latency on the code is extremely low.
  • It only requires the same 1 line of JS code on every page.
  • No server-side slow down as js is rendered by the browser. your site might get FASTER.
  • Very little latency
  • Links are integrated in text paragraphs. Your navigation bars will not be affected.
  • Internal Links are created without further code, the anchors use exact match, synonyms & sentence fragments.
  • Internal linking & Schema is fully interpreted by Google

At any time, you will be able to see the code that is executed.

Where to find the code

If the onboarding has not been completed, you may find the code on logging into your account and selecting the project for your domain. Otherwise, the code will be on the “links” tab.

Step 1:

Find the Project Name without the JS Code here

Step 2:

Installing inLinks on WordPress

If you are not a coder (or even if you are!), then you may be using WordPress to run your website. If you do, then there are many ways to add the code. For example, install the “Insert Headers and Footers” plugin or the “Header and Footer Scripts” plugin and add the code in the footer section there. You do this by:

  • Logging into your blog via the /wp-admin
  • Select “Plugins” then “Add New”
  • in the search bar, search for “Header and Footer” and select based on the reviews and installs
  • Follow the instructions on the screen to make the plugin active and to add the script.

Troubleshooting

When the code is added, checking should immediately be able to verify the installation. If this does not happen, check the tips below.

1: Checking the code is added

We have a button that checks if the code is added under the “links” tab of your project. If we cannot find the script, here are some common issues and fixes.

To check manually, do not use “Viewsource” to look at the code, as you need to inspect the rendered code, not the source. Instead use the “Inspect” button in Chrome (right click on page, “inspect”) or “Inspect Element” in Firefox. You need to check that:

  • jscloud.net is in the page using “CTRL F” to find the code
  • It is near the bottom of the page
  • The ID number being called is the same as the one in your project. This is a four or 5 digit number.

If you need to ask us to check manually, please send a request via the support button.

2: Have you made at least one “Topic Association”?

Associate a topic to at least one page

Our check does not just check the raw code. It also renders the page to make sure that bots can see the schema that is generated. In order to do this, you must have associated at least ONE page to one topic. A green “tick” will then also appear next to the page on the project dashboard. No green ticks? Fix this first.

3: Are you blocking our Crawler?

Please check that:

  • The IP address 199.16.129.36 is not blocked by your firewall (infact, you may wish to whitelist this IP address, so we can see and analyze your content).
  • The user agent “inlinks” is not blocked by your site

4: Is JQuery running?

If all other checks don’t seem to work, we are happy to look for you. The next thing we are likely to check is whether jQuery is being called. One way to do this is to insert this line immediately before our line of code:

<script src = "https://ajax.googleapis.com/ajax/libs/jquery/3.2.1/jquery.min.js"></script>

Please let us know if this solved your issues. We want to know if we can improve these troubleshooting tips.

Why Can’t InLinks see my Script in WordPress?

This is often due to a plugin which is caching code. When you logout of WordPress, the code will often not be visible anymore. You can temporarily disable the plugins to see which one, but for many SEOs, a common one is WP Rocket. If so, this will solve your problem: https://docs.wp-rocket.me/article/915-find-the-right-js-files-to-exclude-from-optimization. The file you need to exclude will be https://jscloud.net/x/***/inlinks.js where the stars are particular to your version of the code.

Please just contact us on the webchat if the code is still not recognized by our systems. If we canot read the code with our bot, we can check manually and make it live for you.

Installing Inlinks using Google Tag Manager

If you are an agency, it is likely that you will not have access to the site itself, but may have access to Google Tag Manager. You can use this to insert the code. A good explanation on how to do that is written here (opens in a new tab).

Installing the code on Wix sites

(Thank you to Chris Wright for these instructions):

  1. Open up settings and click on “Tracking & Analytics”
  2. The page should open up to this.see pics below
  3. Click “+ New Tool”, then click at the bottom “Custom”.
  4. Paste the JavaScript code in the top box. Make sure you select “Body – end” at the bottom of the page.
Wix code Installation
Wix Code installation

Security Considerations

You do not NEED to call the .js file on a third party server if you do not wish to do so, but you will need a developer or system administrator to amend the implementation process. You can see the actual code executed by simply entering the .js link into a browser. The code for all sites beyond the first 600 or so, is this:

// JavaScript Document 
// Substitute pid = xxx for the pid variable in your project
var pid = XXX ;
var jsonPath = "https://jscloud.net/x/" + pid + "/" + window.location.href.replace(/\/|\.|\-|\:|\=|\?/gi, "") + ".json";
 
 jQuery.getJSON(jsonPath, function (data) {
     jQuery.each(data, function(i, element) {
         var t =element['t']; var a = element['a'] ; var n = element['n'] ; 
         if (t === 'p' || t === 'li')
         {
          var o = new RegExp(element['o'],"g"); 
          jQuery( document ).ready( function( $ ){ $(t + ':contains("' + a + '")').html(function(index, html) { return html.replace(o, n); }); });
          
      }
      else if (t === 'h2')
      {
      jQuery( document ).ready( function( $ ){ $(t + ':contains("' + a + '")').after('RELATED CONTENT: ' + n); }) ;
      } 
      else if (t === 's') /* Schema */
      {
      var o = element['o']; 
      var scriptTag = document.createElement("script");
 scriptTag.setAttribute("type", "application/ld+json"); 
 scriptTag.appendChild(document.createTextNode(o)); 
 document.getElementsByTagName("head")[0].appendChild(scriptTag);       
      } 
      
     });
 });

Your web developer may choose to add this code directly or put the .js file on your own server, to avoid a third party server being able to execute a .js file. In doing so, then only .json (text) files are called from third party servers and these are not executable. In this kind of installation, even if a bad actor were to compromise inLinks’ servers, they would not be able to run malicious code on your website by amending the .js file.

What is NOT possible to mitigate is a bad actor being allowed access to your inLinks login. From there, they would be able to add links out of context or delete schema. Do not, therefore, provide login details to untrusted third parties. Removing the javascript would, however, remove all changes made by inLinks.net.

In addition, with the standard code installation, we we global “override” switch to instantly stop (a) all schema and (b) all links generated inlinks. You will find them on the “links” and “schema” tabs. If you would like to verify the installation before it is visible to users, one method is to switch these settings to “off” before adding the code. Then the code’s output can to viewed in the dashboard before making all the link & schema live. Note that the override buttons do not work when a developer add the full .js file noted above directly on their own website.

Modifying the installation

Your developer has the option to only use the code that generates the schema OR only use the code that generates the internal links. If you require further information on how to do this, please ask via the website.

Still got questions? Get in touch!

On the bottom right of your screen, you should see a chat icon. Please contact us through this if you still have problems and we will check your code for you. If you are also suppressing our chat icon, you can also email dixon(at)inlinks.net.

Check this out by @Inlinksnet

About Dixon H Jones, FRSA, MBA, BA(Hons).
A world renowned speaker on search engine algorithms and information retrieval and holder of the Lifetime Achievement Award for services to the search community. Dixon is a moderator on Webmasterworld and has spoken or been published at Search Engine land, State Of Search, WordTracker, Authoritas, SE Roundtable, Brighton SEO, Tedx, Pubcon, and many more.

Comments (1)

  1. Pingback: Onboarding – Setting Topics – InLinks

Leave a comment

Your email address will not be published. Required fields are marked *