Skip to content

BenBtg/thinktank

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ThinkTank

ThinkTank is an installable web application that captures and organize replies to status updates on Twitter and beyond. See screenshots and more at http://thinktankapp.com.

ThinkTank is sponsored by Expert Labs, led by Gina Trapani, and used to be named Twitalytic.

WARNING: Pre-alpha code, PROCEED AT YOUR OWN RISK!

This is not production code. This is a pre-alpha web application. The intended audience is server administrators with experience installing and troubleshooting PHP/MySQL hosted web applications. While ThinkTank uses OAuth to access Twitter, the webapp’s login is not as secure as it should be. Right now this code is for experimentation and tinkering only. Do not run on a public, production server. You have been warned.

INSTALL

In future versions, this will get easier.

System Requirements

Install application files

  • Download source code. Save it one level below your web site’s DocumentRoot. For example, if your site’s DocumentRoot is
    /var/www/vhosts/example.com/httpdocs/
    Save ThinkTank files in
    /var/www/vhosts/example.com/thinktank/
  • Create a symbolic link to the thinktank/webapp directory in your site’s DocumentRoot folder. To do so, cd to the DocumentRoot, and use the command:
    ln -s ../thinktank/webapp/ thinktank
  • Make the following directories writable by the web server:
    thinktank/webapp/templates_c/
    thinktank/webapp/templates_c/cache/
    thinktank/crawler/logs/
  • Note for upgraders: If you’re upgrading a previous installation, delete your cookies (in Firefox under Preferences / Privacy / delete individual cookies).

Set up database

  • Create a database and select it, i.e., CREATE DATABASE thinktank
  • Build tables with thinktank/sql/build-db_mysql.sql

Register your app with Twitter (for OAuth support)

  • Log into Twitter and register your ThinkTank instance. Set the callback URL to
    http://yourserver.com/path-to-thinktank-webapp/account/oauth.php
    Write down the items labeled “Consumer key” and “Consumer secret.”

Configure the app

  • Shared libraries: Rename thinktank/common/config.sample.inc.php to config.inc.php. Add your database credentials, file and webapp paths, and the key/secret you got from Twitter in the previous step.
  • Crawler: Rename thinktank/crawler/config.crawler.sample.inc.php to config.crawler.inc.php and set include path to the absolute location of thintank/common
  • Webapp: Rename thinktank/webapp/config.webapp.sample.inc.php to config.webapp.inc.php and set include path to the absolute location of thinktank/common

RUN

Visit the web application on your server, register and log in, and set up your Twitter accounts.

Then, run the crawler to load your Twitter data:

$ php crawler/crawl.php

To view what’s going on with the crawler, use this command:

$ tail -f crawler/logs/crawler.log

Cron the crawler’s run command to go at least once an hour. Hint: you may configure and cron this pre-fab bash script, which will run the crawler and rotate its logs:

/thinktank/extras/cron/cron

See the script’s README for more information on configuring it.

SUPPORT AND MORE INFORMATION

To discuss ThinkTank, post to the project mailing list. For deeper documentation, see the ThinkTank wiki.

LICENSE

ThinkTank’s source code is licensed under the GNU General Public License, except for Twitter OAuth by Abraham Williams, which is released under the MIT license.

About

ThinkTank captures and organizes replies to your status updates on Twitter (and eventually, beyond).

Resources

License

Stars

Watchers

Forks

Packages

No packages published