• Switch Language


  • Introduction

    Linkify is a breakthrough way to search on mobile devices. Users can access data right at their fingertips, without having to go elsewhere. Just by tapping on the link, a widget appears right on the spot. Once the widget is closed, users resume reading the original article – without any disruption.

    Integrating Linkify into your app is easy. You can install Linkify into your iOS, Android, Titanium, or web apps by copying and pasting in a few lines of code. Once you’ve added your code, Linkify handles everything else.

    Linkify helps you monetize your apps. For developers, this introduces a brand new way of placing ads inside content, without using unattractive banners that reduce screen real estate or interfere with the UI. Linkify currently supports monetization using Google AdSense for search and Amazon Associates.

    Requesting features is most welcomed! Please contact us with your suggestions or ideas to help us improve Linkify!


    Developer Support

    This documentation includes pages below:

    Embed to iOS App

    Add a Script Tag

    All you need to do to integrate Linkify into your app is to simply inject the script tag below into the HTML header of a web page.

    <script type="text/javascript"
      src="http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY">
    </script>
    

    Example of a Webview Application

    We will show you an example of how to make an iOS WebView application with Linkify. We will insert JavaScript code to integrate Linkify into your application. This time, we will use Yahoo! News as an example.

    Add WebView

    Now, we will use a Single View Application as a template. To add a WebView, just choose the storyboard file, then drag and drop the WebView UI that is included in the Objects folder.

    _images/doc_ios_full.jpg

    Modify View Controller

    In ViewController, you have to first define the WebView. The code below is an example of ViewController.h.

    @interface ViewController : UIViewController {
      IBOutlet UIWebView *webView;
    }
    

    The code below is an example of two methods in ViewController.m. What the viewDidLoad method does is simply as just requesting a certain URL (e.g., Yahoo! News). In the webViewDidFinishLoad method, use stringByEvaluatingJavaScriptFromString method to load the JavaScript which inserts a Linkify script tag into the HTML header. We recommend copy & pasting the stringByEvaluatingJavaScriptFromString method from the Linkify page since there exists an environment variable, YOUR_API_KEY inside the code below.

    @interface ViewController ()
    @end
    
    @implementation ViewController
    
    - (void)viewDidLoad
    {
      [super viewDidLoad];
      NSURLRequest* req = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://news.yahoo.com"]];
      [webView loadRequest:req];
      webView.delegate = self;
    }
    
    - (void)webViewDidFinishLoad:(UIWebView *)view
    {
      [webView stringByEvaluatingJavaScriptFromString:@"(function(){if(!window.linkified){var d=document,s=d.createElement('script');s.type='text/javascript';s.src='http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY';d.getElementsByTagName('head')[0].appendChild(s);window.linkified=true;}})()"];
    }
    

    Downloads

    Here is the extended version code of the iOS application that we have just introduced. The code is for iOS 7.

    Embed to Android App

    Add a Script Tag

    All you need to do to integrate Linkify into your application is to simply inject the script tag below into the HTML header of a web page.

    <script type="text/javascript"
      src="http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY">
    </script>
    

    Example of WebView Application

    We will show an example of how to integrate Linkify into your Android WebView application. We will inject the JavaScript code to a web page (we will use Yahoo News! as an example).

    Add WebView

    To add a WebView into your application, simply include the <WebView> element in your activity layout that is placed in res/layout/activity_main.xml. The code below will add a WebView on your screen.

    <?xml version="1.0" encoding="utf-8"?>
    <WebView
      xmls:android="http://schemas.android.com/apk/res/android"
      android:id="@+id/webview"
      android:layout_width="fill_parent"
      android:layout_width="fill_parent"
    />
    
    Allow Internet Access

    Since WebView requires Internet access, you will need to enable Internet access by adding the following codes in your manifest file, which is placed in AndroidManifest.xml.

    <manifest ... >
      <uses-permission android:name="android.permission.INTERNET"/>
    </manifest>
    
    Java Activity

    Here is an example of a Java Activity showing how to load the WebView and integrate Linkify. Before loading any web page, make an instance of WebView and enable the JavaScript. Then, set up the WebView client to integrate Linkify by injecting the JavaScript URL. Finally, load Yahoo! News.

    Notice that in the example below, we have loaded Linkify right after the application loaded. You may edit it to start Linkify by pressing some kind of button or any kind of actions. We recommend copy & pasting the setWebViewClient method from the Linkify page since there exists an environment variable, YOUR_API_KEY inside the code below.

    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);
    
      final WebView webView = (WebView)findViewById(R.id.webView);
    
      WebSettings webSettings = webView.getSettings();
      webSettings.setJavascriptEnabled(true);
      webView.setWebViewClient(new WebViewClient() {
        @Override
        public void onPageFinished(WebView view, String url) {
          view.loadUrl("javascript:(function(){if(!window.linkified){var d=document,s=d.createElement('script');s.type='text/javascript';s.src='http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY';d.getElementsByTagName('head')[0].appendChild(s);window.linkified=true;}})()");
        }
      });
      webView.loadUrl("http://news.yahoo.com");
    }
    

    Downloads

    Here is the code of the Android application that we have introduced above.

    Embed to Titanium App

    Add a Script Tag

    All you need to do to integrate Linkify into your application is to simply add the script tag below in the HTML header of a web page.

    <script type="text/javascript"
      src="http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY">
    </script>
    

    Example of a WebView Application

    We will show an example of how to integrate Linkify into your Titanium WebView application. We will inject the JavaScript URL to a web page (we will use Yahoo News! as an example).

    Creating an Application

    To make a WebView application, choose Default Project when making the Titanium Project.

    Application File

    Here’s an example of the app.js file. First, create a window instance. Next, create a webView instance containing the URL you want to show (e.g., Yahoo! News). Then, add the event listener to the webView so when it is loaded, the JavaScript URL will be added to the HTML header. Finally, add the webView instance into the window. The open method will open the web page! Notice that in the example below, we have loaded Linkify right after the application loaded. You may edit it to start Linkify by pressing a button or any kind of actions. We recommend copy & pasting the addEventListener method from the Linkify page since there exists an environment variable, YOUR_API_KEY inside the code below.

    var window = Titanium.UI.createWindow();
    var webView = Titanium.UI.createWebView({url:"http://news.yahoo.com"});
    
    webView.addEventListener('load', function() {
      webView.evalJS(
        "(function(){if(!window.linkified){var d=document,s=d.createElement('script');s.type='text/javascript';s.src='http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY';d.getElementsByTagName('head')[0].appendChild(s);window.linkified=true;}})()"
          );
    });
    
    window.add(webView);
    window.open();
    

    Downloads

    Here is the code of the Titanium application that we have just introduced.

    Embed to Web pages

    Add a script tag

    All you need to do to integrate Linkify into your web page is to simply add the Linkify script tag inside the <HEAD> tag of your web page. A Linkified web page HTML would look pretty much like the source code below.

    <html>
      <head>
        <http-equiv="Content-Type" content="text/html; charset=utf-8">
        <title>Linkify Test Page<title>
        <script type="text/javascript" src="http://www-static.linkify.mobi/api/linkify.js?key=YOUR_API_KEY">
        </script>
      </head>
      <body>...</body>
    </html>
    

    Using Amazon Associates

    Introduction

    Amazon Associates is a service that will help you monetize your websites and apps by inserting Amazon’s affiliated links into them.

    Linkify lets you manage this monetization by binding your Amazon Associates ID to the Linkify Amazon link in the Linkify widget.

    This section of the documentation covers how to use Amazon Associates with Linkify. If you do not have an Amazon associates account, please register to Amazon Associates on this page .

    Amazon Associates ID

    If you have an Amazon Associates account, please sign in by inputting your address and password in the red frame on this page .

    _images/amazon_en1.png

    Then, copy your Tracking ID in the red frame on the upper left of the page.

    _images/amazon_en2.png

    Create Linkify App

    After copying your tracking ID, please login to Linkify .

    Select the Apps tab at the top of the page, and click Add App. If you would like to bind apps that have already been created, select the required application, and click Edit. Paste the tracking ID you have copied into the Amazon associate ID box.

    _images/amazon_app_en.png

    Finally click Add New App. You are now set up to use Linkify with Amazon Associates.

    Using Linkify as Bookmarklet

    Introduction

    By using bookmarklet, you can easily start to use Linkify in your browser. Linkify’s bookmarklet currently supports Webkit-based browsers (e.g., iOS Safari, Android browsers, Google Chrome, and Safari).

    You can register the bookmarklet into your browser simply by drag and drop the button below to the bookmark bar.

    Now you are ready to try Linkify using bookmarklet. When you click the Linkify’s bookmarklet, the web page will be processed by Linkify and keywords are automatically converted into links.

    FAQ

    The Basics


    What is Linkify?

    Linkify is a tool that enables publishers to give users an enhanced way to rapidly get relevant information as they read and consume content. Linkify automatically links hot keywords that then become searchable for people, places, and things with just one tap. Linkify uses its own intelligent keyword selection engine that automatically generates relevant links based on content. Linkify aims to make finding relevant information on smartphones and tablets faster and smarter while improving the user’s overall reading experience.

    What can I do with Linkify?

    Using Linkify, hotlinks will be automatically generated based on the words within an app, or on a webpage such as a news site or blog. Tapping on those links will pop up services such as Wikipedia, Google, YouTube, etc.. Users can search for additional information.

    Who is the intended audience of the Linkify?

    The benefits Linkify delivers will appeal to readers of news sites, blog reader apps and many mobile apps and webpages that offer or present text-based information to customers.

    Do you have an example that demonstarates how to use of Linkify?

    Please check the documentation by clicking Introduction.

    Getting Started


    What do I need in order to access Linkify?

    Linkify requires an account with any of these services: Twitter, Facebook, Google, or GitHub. For details, please visit the following page .

    How do I get started?
    1. Sign in top right hand corner.
    2. From the admin screen, you’ll need to register the app / webpage for which you want to use Linkify.
    3. Select the style of the links and the widgets.
    4. Copy the JavaScript into your mobile app or webpage.
    How long does it typically take to integrate Linkify?

    Just one step really. Simply copy and paste the JavaScript code away.

    How much does it cost to use Linkify?

    Nothing – Linkify is free.

    Platforms / Languages Supported


    What mobile platforms are supported?

    Linkify is currently available for the Android platform, iOS platform and Titanium Mobile platform.

    What programming languages can I use to develop with Linkify?

    Programming languages supported include: Objective-C for iOS, Java for Android, JavaScript for Titanium, and HTML pages. For more details, please visit Introduction .

    What languages do you support?

    Linkify supports English and Japanese. However, you can only select one of these languages at a time.

    Reporting and Other Services


    What support services are available?

    Wikipedia, Google Search, Google Image Search, Twitter Search, YouTube Search, Google News Search, Flickr Search, and Tumblr Search. For Google Search, developers can also select AdSense for Search, which will help monetization for the app or webpage.

    What type of reporting and/or analytic reporting are available?

    You will see the daily / weekly / monthly page views of pages using Linkify within the admin screen.

    Technical Topics


    Why do configuration changes of widget/app take no effect?

    Linkify caches customized JavaScript not to slow down your application performance. Please wait for about an hour at maximum to refresh JavaScript.

    Please also check out How It Works , as it will help your understand Linkify.

    Go Back to Home

    Read the Docs v: latest
    Versions
    latest
    Downloads
    PDF
    HTML
    Epub
    On Read the Docs
    Project Home
    Builds

    Free document hosting provided by Read the Docs.