Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP

Optional Installations

prozion edited this page · 7 revisions

BIT.LY URL SHORTENING

Simple Blog uses bit.ly url shortening for all automatic postings to Facebook and/or Twitter. If you would like to have either or both of those integrations you will have to add valid credentials in settings.yml

  1. Signup for a new account at http://bit.ly (or login with your existing account)
  2. Follow their instructions to retrieve an API key
  3. Add your login (i.e. user name) and api key to settings.yml
  4. Install the gem url_shortener with the following command: sudo gem install url_shortener

FACEBOOK INTEGRATION

Simple Blog contains a complete integration with Facebook allowing both login using Facebook as well as automatic wall postings. You have the option to link Facebook to make sure these actions can be carried out site wide if you link the Facebook application to the info_account_user_name.

  1. If you haven't setup support for bit.ly url shorterning, first follow the instructions to install bit.ly support!
  2. Install the OAuth2 gem with this command: sudo gem install oauth2
  3. Register your own Facebook application at http://developers.facebook.com/setup/
    • ** Comment: ** You can basically use the standard settings where you only provide the relevant site emails and the proper site url
  4. Add the key and secret to the settings.yml file
  5. If your hostname is http://domain.com make sure your callback url reads: http://domain.com/account/facebook_account/callback

OPTIONAL STEPS:

  1. Login with the info account details
  2. Go to http://domain.com/account/facebook_account (exchange http://domain.com for your root url)
  3. Follow the instructions to link your account to Facebook.

Comments:

  • By linking your info account to Facebook will allow you to login using Facebook as well
  • All posts will be posted to the Facebook wall of the linked Facebook account
  • All users who link their accounts with Facebook will get their posts posted to

TWITTER INTEGRATION

Simple Blog contains a complete integration with Twitter allowing automatic tweeting. You have the option to link Twitter to make sure these actions can be carried out site wide if you link the Twitter application to the info_account_user_name.

  1. If you haven't setup support for bit.ly url shorterning, first follow the instructions to install bit.ly support!
  2. Install the Twitter OAuth2 gem with this command: sudo gem install twitter_oauth2
  3. Register your own Twitter application at http://twitter.com/apps/new
    • Comment: Make sure you choose web application for the type of application
  4. Add the key and secret to the settings.yml file
  5. If your hostname is http://domain.com make sure your callback url reads: http://domain.com/account/twitter_account/callback

OPTIONAL STEPS:

  1. Login with the info account details
  2. Go to http://domain.com/account/twitter_account (exchange http://domain.com for your root url)
  3. Follow the instructions to link your account to Twitter.

Comment: All posts will be posted to Twitter feed of the linked Twitter account

OPENCALAIS SUPPORT FOR TAG SUGGESTION

  1. Go to http://www.opencalais.com and register
  2. Follow their instructions to retrieve an API key
  3. Add the API key to settings.yml
  4. Install the opencalais gem: sudo gem install calais

SPHINX SEARCH SUPPORT

  1. Install Sphinx on your server or local machine
  2. Start the searchd deamon
  3. Make sure the sphinx.yml file has the right port
  4. Run from the project root: rake ts:configure rake ts:start rake ts:dd

  5. Edit settings.yml and add sphinx as the setting for the field search.

GOOGLE WEBMASTER SUPPORT

Simple Blog contains extensive support for SEO and it is strongly suggested that you add the sitemap as well.

  1. Login or register for a new Google Account
  2. Go to http://www.google.com/webmasters/tools
  3. Add your site
  4. Choose verification meta code (DO NOT CLICK VERIFY YET!)
  5. Add the code to settings.yml
  6. Restart your server
  7. Click Verify

OPTIONAL STEPS:

  1. Inside Google Webmaster Tools, click Site Configuration >> Sitemaps
  2. Click Add a sitemap
  3. Add sitemap.posts

Comment: If you add the sitemap you will ensure that new posts get crawled by Google efficiently.

GOOGLE ANALYTICS SUPPORT

  1. Login or register for a new Google Account
  2. Register a new profile and site at http://analytics.google.com
  3. Add your newly created site Google Analytics Id to settings.yml
  4. Restart your server

ADD EMAIL POSTING SUPPORT

  1. Create an email account using your control panel or equivalent
  2. Add the relevant settings to settings.yml
  3. Restart your server
  4. Add a scheduled job per as your server : cd PROJECT_ROOT; export RAILS_ENV=production; /usr/bin/ruby script/mail_poller >> log/mail_poller.log

Comment: Substitute PROJECT_ROOT for your full path to your Rails project.

ADD SOCIAL MEDIA & SUBSCRIBE

Inside settings.yml you will find extensive support for many of the popular social media sites. Below you find these explained in more details.

:social:
    :share_this: "signup at ShareThis and add your API key here"
    :feedburner: "add your feedburner feed id here"
    :facebook_widget_id: "if you have a Gacebook page, add the id of the page here"
    :subscribe:
        :facebook: "this is the url to any Facebook url you would like to push for"
        :twitter: "this is the url to the Twitter page you would like to market"
        :blogtalkradio: "this is the url to the Blog Talk Radio page you would like to market"
        :youtube: "this is the url to the YouTube page you would like to market"
        :itunes: "this is the url to the iTunes feed you would like to market, soon Simple Blog will allow for extensive audio support"
        :flickr: "this is the url to the Flickr page you would like to market"
Something went wrong with that request. Please try again.