Module: RPXNow

Extended by:
RPXNow
Included in:
RPXNow
Defined in:
lib/rpx_now.rb,
lib/rpx_now/api.rb,
lib/rpx_now/user_proxy.rb,
lib/rpx_now/user_integration.rb,
lib/rpx_now/contacts_collection.rb

Defined Under Namespace

Modules: UserIntegration Classes: Api, ApiError, ContactsCollection, ServerError, ServiceUnavailableError, UserProxy

Constant Summary collapse

VERSION = 
File.read( File.join(File.dirname(__FILE__),'..','VERSION') ).strip

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#api_key ⇒ Object

Returns the value of attribute api_key.



8
9
10
 
# File 'lib/rpx_now.rb', line 8

def api_key
  @api_key
end

#api_version ⇒ Object

Returns the value of attribute api_version.



9
10
11
 
# File 'lib/rpx_now.rb', line 9

def api_version
  @api_version
end

#domain ⇒ Object

Returns the value of attribute domain.



10
11
12
 
# File 'lib/rpx_now.rb', line 10

def domain
  @domain
end

Instance Method Details

#activity(identifier, activity_options, options = {}) ⇒ Object

Post an activity update to the user’s activity stream. See more: rpxnow.com/docs#api_activity



60
61
62
63
 
# File 'lib/rpx_now.rb', line 60

def activity(identifier, activity_options, options={})
  options = options.merge(:identifier => identifier, :activity => activity_options.to_json)
  Api.call("activity", options)
end

#all_mappings(options = {}) ⇒ Object 



80
81
82
 
# File 'lib/rpx_now.rb', line 80

def all_mappings(options={})
  Api.call("all_mappings", options)['mappings']
end

#auth_info(token, options = {}) ⇒ Object

same data as user_data, but without any kind of post-processing



37
38
39
40
 
# File 'lib/rpx_now.rb', line 37

def auth_info(token, options={})
  data = Api.call("auth_info", options.merge(:token => token))
  with_indifferent_access(data)
end

#contacts(identifier, options = {}) ⇒ Object Also known as: get_contacts 



84
85
86
87
 
# File 'lib/rpx_now.rb', line 84

def contacts(identifier, options={})
  data = Api.call("get_contacts", options.merge(:identifier => identifier))
  RPXNow::ContactsCollection.new(data['response'])
end

#embed_code(subdomain, url, options = {}) ⇒ Object

embedded rpx login (via iframe) options: :width, :height, :language, :flags, :api_version, :default_provider



92
93
94
95
96
97
98
99
 
# File 'lib/rpx_now.rb', line 92

def embed_code(subdomain, url, options={})
  options = {:width => '400', :height => '240'}.merge(options)
  <<-EOF
    <iframe src="#{Api.host(subdomain)}/openid/embed?#{embed_params(url, options)}"
      scrolling="no" frameBorder="no" style="width:#{options[:width]}px;height:#{options[:height]}px;" id="rpx_now_embed" allowtransparency="allowtransparency">
    </iframe>
  EOF
end

#extract_version(options) ⇒ Object 



137
138
139
 
# File 'lib/rpx_now.rb', line 137

def extract_version(options)
  options[:api_version] || api_version
end

#get_user_data(identifier, options = {}) ⇒ Object

same as for auth_info if Offline Profile Access is enabled, but can be called at any time and does not need a token / does not expire



44
45
46
47
 
# File 'lib/rpx_now.rb', line 44

def get_user_data(identifier, options={})
  data = Api.call("get_user_data", options.merge(:identifier => identifier))
  with_indifferent_access(data)
end

#map(identifier, primary_key, options = {}) ⇒ Object

maps an identifier to an primary-key (e.g. user.id)



66
67
68
 
# File 'lib/rpx_now.rb', line 66

def map(identifier, primary_key, options={})
  Api.call("map", options.merge(:identifier => identifier, :primaryKey => primary_key))
end

#mappings(primary_key, options = {}) ⇒ Object

returns an array of identifiers which are mapped to one of your primary-keys (e.g. user.id)



76
77
78
 
# File 'lib/rpx_now.rb', line 76

def mappings(primary_key, options={})
  Api.call("mappings", options.merge(:primaryKey => primary_key))['identifiers']
end

#popup_code(text, subdomain, url, options = {}) ⇒ Object

popup window for rpx login options: :language, :flags, :unobtrusive, :api_version, :default_provider, :html



103
104
105
106
107
108
109
 
# File 'lib/rpx_now.rb', line 103

def popup_code(text, subdomain, url, options = {})
  if options[:unobtrusive]
    unobtrusive_popup_code(text, subdomain, url, options)
  else
    obtrusive_popup_code(text, subdomain, url, options)
  end
end

#popup_source(subdomain, url, options = {}) ⇒ Object

javascript for popup only needed in combination with popup_code(x,y,z, :unobtrusive => true)



113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
 
# File 'lib/rpx_now.rb', line 113

def popup_source(subdomain, url, options={})
  <<-EOF
    <script src="#{Api.host}/openid/v#{extract_version(options)}/widget" type="text/javascript"></script>
    <script type="text/javascript">
      //<![CDATA[
      setTimeout(function () {
        RPXNOW.token_url = '#{url}';
        RPXNOW.realm = '#{subdomain}';
        RPXNOW.overlay = true;
        #{ "RPXNOW.language_preference = '#{options[:language]}';" if options[:language] }
        #{ "RPXNOW.default_provider = '#{options[:default_provider]}';" if options[:default_provider] }
        #{ "RPXNOW.flags = '#{options[:flags]}';" if options[:flags] }
      }, 1000);
      //]]>
    </script>
  EOF
end

#popup_url(subdomain, url, options = {}) ⇒ Object

url for unobtrusive popup window options: :language, :flags, :api_version, :default_provider



133
134
135
 
# File 'lib/rpx_now.rb', line 133

def popup_url(subdomain, url, options={})
  "#{Api.host(subdomain)}/openid/v#{extract_version(options)}/signin?#{embed_params(url, options)}"
end

#set_status(identifier, status, options = {}) ⇒ Object

set the users status



50
51
52
53
54
55
56
 
# File 'lib/rpx_now.rb', line 50

def set_status(identifier, status, options={})
  options = options.merge(:identifier => identifier, :status => status)
  Api.call("set_status", options)
rescue ServerError
  return nil if $!.to_s=~/Data not found/
  raise
end

#unmap(identifier, primary_key, options = {}) ⇒ Object

un-maps an identifier to an primary-key (e.g. user.id)



71
72
73
 
# File 'lib/rpx_now.rb', line 71

def unmap(identifier, primary_key, options={})
  Api.call("unmap", options.merge(:identifier => identifier, :primaryKey => primary_key))
end

#user_data(token, options = {}) ⇒ Object

retrieve the users data

  • cleaned Hash

  • complete/unclean response when block was given user_data{|response| …; return hash }

  • nil when token was invalid / data was not found



21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/rpx_now.rb', line 21

def user_data(token, options={})
  options = options.dup
  return_raw = options.delete(:raw_response)

  data = begin
    auth_info(token, options)
  rescue ServerError
    return nil if $!.to_s=~/Data not found/
    raise
  end

  result = (block_given? ? yield(data) : (return_raw ? data : parse_user_data(data, options)))
  with_indifferent_access(result)
end