easypay 1.0.2 → 1.0.3

data/README.md

@@ -0,0 +1,110 @@
+Easypay
+=========
+
+_Easypay_ is a Ruby client for [Easypay](http://www.easypay.pt/) payment platform that allows payments with credit cards and (MB references to Portugal)
+
+Installation
+------------
+
+OK. First, you need to talk with people from Easypay to get your credentials!
+
+Now, let's install the gem via Rubygems:
+
+    $ gem install easypay
+
+Or in your Gemfile:
+
+    $ gem 'easypay'
+    
+After bundle:
+    
+    $ rails generate easypay
+    $ rake db:migrate
+
+Check on your initializers folder for easypay.rb and change the parameters:
+
+```ruby
+
+  # CIN USER and ENTITY, are required
+  config.cin = 'cin provided by Easypay'
+  config.user = 'user provided by Easypay'
+  config.entity = 'entity provided by Easypay'
+
+  # Code is needed only if you don't have validation by IP Address
+  config.code = 'Code is needed only if you don't have validation by IP Address (Configure on Easypay Backoffice)'
+  
+  # Change routes in order to work them on your app
+  config.easypay_notification_path = '/easypay/notifications.:format'
+  config.easypay_forward_path = '/easypay/forwards.:format'
+  config.easypay_payment_path = '/easypay/payments.:format'
+  config.redirect_after_payment_path = '/easypay/completed'
+  config.redirect_payment_notification_path = '/easypay/payment_completed'
+```
+
+Basic configuration
+-----
+
+In your model, add:
+
+```ruby
+  acts_as_payable :name => 'your_model_name_attr_if_different_from_name', 
+                  :email => 'your_model_email_attr_if_different_from_email', 
+                  :mobile => 'your_model_mobile_attr_if_different_from_mobile',
+                  :item_description => ''your_model_item_description_attr_if_different_from_item_description', 
+                  :item_quantity => 'your_model_item_quantity_attr_if_different_from_item_quantity', 
+                  :value => 'your_model_value_attr_if_different_from_value', 
+                  :description => 'your_model_description_attr_if_description_from_email', 
+                  :obs => 'your_model_obs_attr_if_different_from_obs'
+```
+
+
+How to?
+------
+
+In your controller:
+
+```ruby
+  payment_reference = @bill.create_payment_reference
+  
+  # check if success
+  
+  if payment_reference[:success]
+  
+  # access your payment_references easy
+  
+  @bill.payment_references
+
+```
+
+
+You can work response (configure your routes on easypay.rb)
+
+```ruby
+  Easypay::PaymentReference.find_by_ep_key(params[:ep_key])
+```
+
+Delete or update payment reference:
+
+```ruby
+  # delete payment reference
+  @payment_reference.modify("delete")
+  
+  # update
+  @payment_reference.modify("update")
+```
+
+Check Logs of every request and notification on table easypay_logs
+
+Todo?
+------
+
+Feel free to contact me, you have your say.
+
+I will put in github working project using gem
+
+
+Copyright
+------
+Authors: Guilherme Pereira
+
+

data/easypay.gemspec

@@ -3,13 +3,13 @@ $:.push File.expand_path("../lib", __FILE__)
 
 Gem::Specification.new do |s|
   s.name        = "easypay"
-  s.version     = "1.0.2"
+  s.version     = "1.0.3"
   s.authors     = ["Guilherme Pereira"]
   s.email       = ["guiferrpereira@gmail.com"]
   s.homepage    = ""
   s.summary     = %q{This Gem provides connection to easypay API}
   s.description = %q{This Gem provides connection to easypay API, that allow you to use credit cards and MB references to Portugal}
-  s.extra_rdoc_files = ["README.markdown"]
+  s.extra_rdoc_files = ["README.md"]
   
   s.rubyforge_project = "easypay"
   

data/lib/rails/generators/easypay/easypay_generator.rb

@@ -23,35 +23,5 @@ class EasypayGenerator < Rails::Generators::Base
   def copy_initializer_file
     copy_file 'initializer.rb', 'config/initializers/easypay.rb'
   end
-
-  # def update_application_template
-  #   f = File.open "app/views/layouts/application.html.erb"
-  #   layout = f.read; f.close
-  #   
-  #   if layout =~ /<%=[ ]+yield[ ]+%>/
-  #     print "    \e[1m\e[34mquestion\e[0m  Your layouts/application.html.erb layout currently has the line <%= yield %>. This gem needs to change this line to <%= content_for?(:content) ? yield(:content) : yield %> to support its nested layouts. This change should not affect any of your existing layouts or views. Is this okay? [y/n] "
-  #     begin
-  #       answer = gets.chomp
-  #     end while not answer =~ /[yn]/i
-  #     
-  #     if answer =~ /y/i
-  #       
-  #       layout.gsub!(/<%=[ ]+yield[ ]+%>/, '<%= content_for?(:content) ? yield(:content) : yield %>')
-  # 
-  #       tmp_real_path = File.expand_path("tmp/~application.html.erb")
-  # 
-  #       tmp = File.open tmp_real_path, "w"
-  #       tmp.write layout; tmp.close
-  # 
-  #       remove_file 'app/views/layouts/application.html.erb'
-  #       copy_file tmp_real_path, 'app/views/layouts/application.html.erb'
-  #       remove_file tmp_real_path
-  #     end
-  #   elsif layout =~ /<%=[ ]+content_for\?\(:content\) \? yield\(:content\) : yield[ ]+%>/
-  #     puts "    \e[1m\e[33mskipping\e[0m  layouts/application.html.erb modification is already done."
-  #   else
-  #     puts "    \e[1m\e[31mconflict\e[0m  The gem is confused by your layouts/application.html.erb. It does not contain the default line <%= yield %>, you may need to make manual changes to get this gem's nested layouts working. Visit ###### for details."
-  #   end
-  # end
   
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: easypay
 version: !ruby/object:Gem::Version 
-  hash: 19
+  hash: 17
   prerelease: 
   segments: 
   - 1
   - 0
-  - 2
-  version: 1.0.2
+  - 3
+  version: 1.0.3
 platform: ruby
 authors: 
 - Guilherme Pereira
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-07-24 00:00:00 Z
+date: 2012-07-27 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: nokogiri
@@ -39,11 +39,11 @@ executables: []
 extensions: []
 
 extra_rdoc_files: 
-- README.markdown
+- README.md
 files: 
 - .gitignore
 - Gemfile
-- README.markdown
+- README.md
 - Rakefile
 - VERSION
 - app/controllers/easypay/notifications_controller.rb

data/README.markdown

@@ -1,57 +0,0 @@
-Easypay
-=========
-
-_Easypay_ is a Ruby client for [Easypay](http://www.easypay.pt/) payment platform that allows payments with credit cards and (MB references to Portugal)
-
-Installation
-------------
-
-OK. First, you need to talk with people from Easypay to get your credentials!
-
-Now, let's install the gem via Rubygems:
-
-    $ gem install easypay
-
-Or in your Gemfile:
-
-    $ gem 'easypay'
-    
-After bundle:
-    
-    $ rails generate easypay
-
-Check on your initializers folder for easypay.rb and change the parameters:
-
-```ruby
-  config.cin = 'CIN provided by Easypay' 
-  config.user = 'USER provided by Easypay'
-  config.entity = 'Entity provided by Easypay'
-  config.code = 'Code is needed only if you don't have validation by IP Address (Configure on Easypay Backoffice)'
-```
-
-Usage
------
-
-Start Easypay call:
-
-```ruby
-  Easypay::Client.new
-```
-
-If you don't configure your easypay.rb with these params, you can start your object like this:
-
-```ruby
-  Easypay::Client.new(:easypay_cin => xxxx, 
-                      :easypay_entity => xxxx, 
-                      :easypay_user => xxxx, 
-                      :easypay_code => xxxx, 
-                      :easypay_ref_type => xxx, 
-                      :easypay_country => xxxx)
-```                      
-
-In order to get one payment reference:
-
-```ruby
-  Easypay::Client.new.create_reference('token_you_generate', 'value_of_payment', 'client_language', 'client_name', 'client_mobile', 'client_email')
-```
-