Home

How it works

links creates a community by helping it's users share web content with each other.

The primary function is to find and store URLs. The URLs can be collected from three different sources, IRC (logs), twitter (@mentions) and pocket (http://www.getpocket.com). Each collector is enabled individually.

To send a link from IRC just say the URL into the channel, any additional text on the URL line will also be saved. The eggdrop bot will write the channel text to the log file and the collector will find it.

To send a link from twitter, @mention the twitter account for links in your tweet with the URL. The user must first be following the twitter account for the collector to accept the URL. This prevents SPAM posts from twitter.

The pocket collector grabs all of the links you add to your personal pocket account. First users must authorize their personal pocket account on the link-up web page. Use the pocket browser extensions to link straight from the desktop browser. Pocket also has mobile apps for android, iphone and ipad to quickly "share" links from other mobile apps.

Collectors will attempt to find the <title> for each URL that looks like a web page, and store it in the database. A primary feature of the collectors is to download any images it finds and create a thumbnail for viewing in the thumbs gallery. Additionally there is support for storing the images in Amazon's Simple Storage Service (S3) (http://aws.amazon.com/s3/).

links runs on an Apache/PHP/MySQL back-end and the collectors are perl scripts. The web interface is built on the twitter bootstrap UI (http://www.getboostrap.com).

This diagram shows some of the technologies used within links and their relationships.

This diagram shows the logical work flow of the collector scripts.

How it looks

links

The main links page has all of the URLs that have been collected.

• If it was a web page the <title> will be displayed.
• If an image is downloaded you will see a link to the (cache)ed copy.
• The numbered badges in the menu tell you how many new posts since the last visit without refreshing the page.
• Use the settings to hide the "cached" thumbs or all of the vids from this page.

thumbs

The thumbs page has all of the images that have been downloaded.

• Automatic width detection using the bootstrap UI. (http://www.getbootstrap.com)
• Click an image to open it in the lightbox. (http://blueimp.github.io/Bootstrap-Image-Gallery/)
• In the lightbox swipe left/right/up/down in on tablet and mobile.
• Settings
• Add or remove the details box under the images
• Add or remove videos from this page

thumbs lightbox

vids

The vids page has all of the videos embedded on one page.

• Supports Youtube and Vimeo

vids lightbox:

link-up

The link-up page is where you can authorize your pocket account or follow the twitter account.

settings

What you need

System

• Apache

• MySQL

• PHP

• perl (collector scripts)

• perl modules

  • DBI & POSIX
  • LWP::UserAgent (LibWWW-perl)
  • URI
  • MIME::Types
  • Encode
  • File

• Optional:

• perl Image Magick (Image Download)

  • perl File::LibMagic (better mime type detection)

• perl Net::Telnet (Bot Chat)

• perl Net::Twitter (Twitter Post)

• perl NET::Amazon::S3 (Amazon S3 Storage)

Collectors

IRC

• Eggdrop (tcl-devel)

Twitter

• perl Net::Twitter
• perl Crypt::SSLeay
• perl WWW::Shorten::Bitly

Pocket

• perl WebService::Pocket::Lite (https://github.com/kiririmode/p5-WebService-Pocket-Lite)
• perl Crypt::SSLeay
• perl Class::Accessor::Lite