Skip to content

rlucia/Circular

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Circular

An open source Buffer app built on Backbone, Bootstrap and MongoDB

http://circular.io


Circular is built as a Backbone.js application that communicates with a MongoDB datastore through a REST API written in PHP.

The server part, based on the Silex PHP micro-framework, is intended to be the dumbest possible, i.e. we tried to put most "intelligence" in the Backbone app, not in the API. (For example, the API only takes UNIX timestamps and posts' content, while the Backbone app computes the scheduled timestamps).

A daemon based on PHP-Daemon then runs in the background and is responsible for sending your posts to Twitter when they're due.

Installation


Prerequisites:

Installation:

  • Make sure you cloned this repo recursively, i.e. with submodules that are in extlib
  • Create a new Twitter application on dev.twitter.com, then copy your credentials into api/config.php.sample and rename it to api/config.php
  • Install the Silex application dependencies using Composer: cd api && composer install
  • Create an uploads directory and make it writable by the Web server
  • Your application's frontend should now be accessible where you set it up, for instance at http://localhost/Circular. The MongoDB datastore's name will be circular (you don't have to explicitly create it).
  • Start the daemon with php Daemon/run.php
    • Use option -d to run as daemon, i.e. detach and run in the background
    • Your daemon's log will be in /var/log/daemons/circular, or if this is not writable, in Daemon/logs. You can use/rotate this log to monitor your daemon.
  • That's it!

License


About

An open source Buffer app clone (ex-Tampon)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 90.7%
  • PHP 5.7%
  • Perl 2.6%
  • Other 1.0%