slayer-rpx_now 0.6.24

data/.gitignore

@@ -0,0 +1,6 @@
+Manifest
+pkg
+.*.swp
+.*.swo
+*.autotest
+.bundle

data/CHANGELOG

@@ -0,0 +1,38 @@
+0.6.13
+------
+ * return an indifferent hash from user_data when possible
+
+0.6.12
+-----
+ * url encode obstrusive popup code token-url
+0.6.0
+-----
+ * removed optional api key as parameter: RPXNow.user_data(token, api_key, options) --> RPXNow.user_data(token, options), you may use :apiKey=>... instead
+
+0.5.9
+-----
+  * Switched from Get to Post requests
+
+0.5.0
+----
+  * ApiError is raised when API KEY was invalid (before did only return nil)
+  * ServerError is now seperated into ApiError and ServiceUnavailableError
+
+0.4.2
+----
+  * default IDs are strings, not integers, since RPX supports both
+  * Added username field to standart parameters
+
+0.4
+----
+  * The RPXNow.api_version= can be set globally
+  * Most methods now support :api_version=>'123', so you can specify the api_version on each call
+	* Added support for unobtrusive code generation. This will make the gem play nicely with developers creating unobtrusive pages with frameworks such as jQuery;
+	* The RPXNOW JSON responses are now parsed by Florian Frank JSON gem (http://json.rubyforge.org/);
+	* Removed the dependency of ActiveSupport. However, if present, ActiveSupport will be used due to its convenience methods Array#to_query and Hash#to_query.
+	* Added support for multiple versions of the widget. By default, everything will point to version 2;
+	* The specs have been updated.
+
+0.3
+----
+	* RPXNow::ServerError will be thrown when something is invalid/goes wrong, so watch out (not for invalid tokens in user_data)...

data/Gemfile

@@ -0,0 +1,12 @@
+# not used, just for hardcore-bundlers
+source :rubygems
+
+group :dev do
+  gem "rake"
+  gem "json"
+  gem "jeweler"
+end
+
+group :test do
+  gem "rspec", "~>2"
+end

data/Gemfile.lock

@@ -0,0 +1,28 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    json (1.4.6)
+    rake (0.8.7)
+    rspec (2.5.0)
+      rspec-core (~> 2.5.0)
+      rspec-expectations (~> 2.5.0)
+      rspec-mocks (~> 2.5.0)
+    rspec-core (2.5.1)
+    rspec-expectations (2.5.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.5.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  jeweler
+  json
+  rake
+  rspec (~> 2)

data/MIGRATION

@@ -0,0 +1,9 @@
+class AddIdentifierToUsers < ActiveRecord::Migration
+  def self.up
+    add_column :users, :identifier, :string
+  end
+
+  def self.down
+    remove_column :users, :identifier
+  end
+end

data/Rakefile

@@ -0,0 +1,22 @@
+task :default => :spec
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = '--backtrace --color'
+end
+
+begin
+  require 'jeweler'
+
+  Jeweler::Tasks.new do |gem|
+    gem.name = 'slayer-rpx_now'
+    gem.summary = "Helper to simplify RPX Now user login/creation"
+    gem.email = "devvlad@gmail.com"
+    gem.homepage = "http://github.com/slayer/#{gem.name}"
+    gem.authors = ["Michael Grosser", "Vlad Moskovets"]
+    gem.add_dependency ['json_pure']
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler, or one of its dependencies, is not available. Install it with: sudo gem install jeweler"
+end

data/Readme.md

@@ -0,0 +1,165 @@
+[Janrain Engage](http://www.janrain.com/products/engage) (formerly known as RPXNow):
+
+ - Login to your page through Facebook / Twitter / Myspace / Google / OpenId / MS-LiveId / AOL / ...
+ - Simpler then OpenId/OAuth/xxx for developers AND users
+ - Publish user activity to facebook/twitter/myspace/.../-stream via the same API
+ - Returning users are greeted by their choosen provider
+ - Free for up to 2500 accounts/year (above 5k it gets [expensive](http://www.janrain.com/products/engage/pricing)...)
+
+![Single Interface for all providers](https://s3.amazonaws.com/static.rpxnow.com/rel/img/a481ed2afccd255350cccd738050f873.png)
+![Share comments and activities](https://s3.amazonaws.com/static.rpxnow.com/rel/img/50bdccdb32b6ae68d46908a531492b28.png)
+![Visitors choose from providers they already have](https://s3.amazonaws.com/static.rpxnow.com/rel/img/f4a6e65808eefcf8754588c71f84c142.png)
+
+Usage
+=====
+ - Get an API key @ [Janrain Engage](http://www.janrain.com/products/engage)
+ - run [MIGRATION](http://github.com/grosser/rpx_now/raw/master/MIGRATION)
+ - Build login view
+ - Receive user-data from Janrain to create or login User
+ - for more advanced features have a look at the [Janrain Engage API Docs](http://documentation.janrain.com)
+
+Install
+=======
+ - As Rails plugin: `rails plugin install git://github.com/grosser/rpx_now.git`
+ - As gem: `sudo gem install rpx_now`
+
+Examples
+========
+
+[Example application](http://github.com/grosser/rpx_now_example), go play around!
+
+environment.rb
+--------------
+
+    RPXNow.api_key = "YOU RPX API KEY"
+
+Controller
+----------
+This example uses the SessionsController, if you dont have one built it and add routes(rpx_token is a post request)
+
+    skip_before_filter :verify_authenticity_token, :only => [:rpx_token] # RPX does not pass Rails form tokens...
+
+    # user_data
+    # found: {:name=>'John Doe', :username => 'john', :email=>'john@doe.com', :identifier=>'blug.google.com/openid/dsdfsdfs3f3'}
+    # not found: nil (can happen with e.g. invalid tokens)
+    def rpx_token
+      raise "hackers?" unless data = RPXNow.user_data(params[:token])
+      self.current_user = User.find_by_identifier(data[:identifier]) || User.create!(data)
+      redirect_to '/'
+    end
+
+    # getting additional profile fields (these fields are rarely filled)
+    # all possibilities: https://rpxnow.com/docs#profile_data
+    data = RPXNow.user_data(params[:token], :additional => [:gender, :birthday, :photo, :providerName, ...])
+
+    # normal + raw data
+    RPXNow.user_data(params[:token], :additional => [:raw_response])[:raw_response]['profile]['verifiedEmail']
+
+    # only raw data
+    email = RPXNow.user_data(params[:token], :raw_response => true)['profile']['verifiedEmail']
+
+    # with extended info like friends, accessCredentials, portable contacts. (most Providers do not supply them)
+    RPXNow.user_data(params[:token], :extended => true)[:extended]['friends'][...have a look at the RPX API DOCS...]
+
+View
+----
+
+    <%=RPXNow.embed_code('My-Rpx-Domain', url_for(:controller => :session, :action => :rpx_token, :only_path => false))%>
+    OR
+    <%=RPXNow.popup_code('Login here...', 'My-Rpx-Domain', url_for(:controller => :session, :action => :rpx_token, :only_path => false), options)%>
+
+###Options
+`:language => 'en'` janrain tries to detect the users language, but you may overwrite it [possible languages](http://documentation.janrain.com/engage/widgets/localization)<br/>
+`:default_provider => 'google'` [possible default providers](http://documentation.janrain.com/engage/widgets/sign-in#TOC-Default-Provider)<br/>
+`:flags => 'show_provider_list'` [possible flags](http://documentation.janrain.com/engage/widgets/sign-in)<br/>
+`:html => {:id => 'xxx'}` is added to the popup link (popup_code only)
+
+###Unobtrusive / JS-last
+`popup_code` can also be called with `:unobtrusive => true` ( --> just link without javascript include).
+To still get the normal popup add `RPXNow.popup_source('My-Rpx-Domain', url_for(:controller => :session, :action => :rpx_token, :only_path => false), [options])`<br/>
+Options like :language / :flags should be given for both.
+
+Advanced
+--------
+### Versions
+    RPXNow.api_version = 2
+
+### Custom domain (Plus/Pro)
+    RPXNow.domain = 'other-domain.com'
+
+### Mappings (Plus/Pro)
+You can map your primary keys (e.g. user.id) to identifiers, so that<br/>
+users can login to the same account with multiple identifiers.
+
+    RPXNow.map(identifier, primary_key) #add a mapping
+    RPXNow.unmap(identifier, primary_key) #remove a mapping
+    RPXNow.mappings(primary_key) # [identifier1,identifier2,...]
+    RPXNow.all_mappings # [["1",['google.com/dsdas','yahoo.com/asdas']], ["2",[...]], ... ]
+
+After a primary key is mapped to an identifier, when a user logs in with this identifier,
+`RPXNow.user_data` will contain his `primaryKey` as `:id`.
+A identifyer can only belong to one user (in doubt the last one it was mapped to)
+
+### User integration (e.g. ActiveRecord)
+    class User < ActiveRecord::Base
+      include RPXNow::UserIntegration
+    end
+
+    user.rpx.identifiers == RPXNow.mappings(user.id)
+    user.rpx.map(identifier) == RPXNow.map(identifier, user.id)
+    user.rpx.unmap(identifier) == RPXNow.unmap(identifier, user.id)
+
+### Contacts (Pro)
+Retrieve all contacts for a given user:
+    RPXNow.contacts(identifier).each {|c| puts "#{c['displayName']}: #{c['emails']}}
+
+### Status updates (Pro)
+Send a status update to provider (a tweet/facebook-status/...) :
+    RPXNow.set_status(identifier, "I just registered at yourdomain.com ...")
+
+### Activity (Pro)
+Post a users activity, on their e.g. Facebook profile, complete with images, titels, rating, additional media, customized links and so on ...
+
+    RPXNow.activity( identifier,
+      :url => href, :action => 'Im loving my new', :user_generated_content => 'Im loving my new ... ',
+      :title => product.title, :description => product.description,
+      :action_links => [{:text => 'view >>', :href => product_url(product, :only_path => false)}],
+      :media => [{:type => :image, :src => product.image_url, :href => product_url(product, :only_path => false)}]
+    )
+
+### Offline user data access (Plus/Pro)
+Same response as auth_info but can be called with a identifier at any time.<br/>
+Offline Profile Access must be enabled.
+
+    RPXNow.get_user_data(identifier, :extended => true)
+
+### Auth info
+Same response as user_data with :raw_response, but without any kind of failure detection or post processing.
+    RPXNow.auth_info(params[:token])
+
+Author
+======
+
+__[rpx_now_gem mailing list](http://groups.google.com/group/rpx_now_gem)__
+
+
+### [Contributors](http://github.com/grosser/rpx_now/contributors)
+ - [Amunds](http://github.com/Amunds)
+ - [Bob Groeneveld](http://metathoughtfacility.blogspot.com)
+ - [DBA](http://github.com/DBA)
+ - [dbalatero](http://github.com/dbalatero)
+ - [Paul Gallagher](http://tardate.blogspot.com/)
+ - [jackdempsey](http://jackndempsey.blogspot.com)
+ - [Patrick Reagan (reagent)](http://sneaq.net)
+ - [Joris Trooster (trooster)](http://www.interstroom.nl)
+ - [Mick Staugaard (staugaard)](http://mick.staugaard.com/)
+ - [Kasper Weibel](http://github.com/weibel)
+ - [Nicolas Alpi](http://www.notgeeklycorrect.com)
+ - [Ladislav Martincik](http://martincik.com)
+ - [Ben Aldred](http://github.com/benaldred)
+ - [Casper Fabricius](http://casperfabricius.com)
+ - [Avi Flombaum](http://www.aviflombaum.com)
+
+[Michael Grosser](http://grosser.it)<br/>
+michael@grosser.it<br/>
+Hereby placed under public domain, do what you want, just do not hold me accountable...

data/VERSION

@@ -0,0 +1 @@
+0.6.24