Welcome to Potion Store
- PayPal Website Payments Pro support
- PayPal Express Checkout support
- Google Checkout support
- Administration interface with some simple sales charts
- Send lost license page (http://mycompany.com/store/lost_license)
- Google Analytics e-commerce transaction tracking support for PayPal and credit card orders
- Rails 3.0 or higher.
- PostgreSQL or MySQL
This is a brief outline of the steps required to get the development environment of Potion Store up and running on your local machine.
Install gems via Bundler
Edit the following config files to suit your needs
Create config/google_checkout.yml. Modify it with your credentials.
# Settings for Google Checkout # Get these by logging into Google Checkout's merchant site and the sandbox equivalent development: gcheckout_merchant_id: "XXXXXXXXXXXXXXX" gcheckout_merchant_key: "XXXXXXXXXXXXXXXXXXXXXX" test: gcheckout_merchant_id: "XXXXXXXXXXXXXXX" gcheckout_merchant_key: "XXXXXXXXXXXXXXXXXXXXXX" production: gcheckout_merchant_id: "XXXXXXXXXXXXXXX" gcheckout_merchant_key: "XXXXXXXXXXXXXXXXXXXXXX"
Create config/paypal.yml. Modify it with your credentials.
# PayPal API Access Setup # # Instructions: # # 1. Go to https://developer.paypal.com/. # 2. Create an account if you don't have one. # 3. Click the "Test Accounts" on the left sidebar. # 4. Create a Business Test Account if you don't have one. # 5. Select the Business Test Account and click the "Enter Sandbox Test Site" button. # 6. Once you log in, click "Profile." # 7. Click on "API Access." # 8. Click the "Request API Credentials" link. # 9. Leave the default selection on "Request API signature" and click the "Agree and Submit" button. # 10. Fill in api_username and api_password and api_signature with the given information. # Development settings development: pi_username: "XXXXXXXXXXXXXXXXXXXXXXXXXXX" api_password: "XXXXXXXXXXXXXXXX" api_signature: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" wiredump: true # Turn on logging of communications with PayPal during development # Follow steps 6 to 10 but with your real PayPal account. # NOTE: Your PayPal account must have Website Payments Pro already for this to work. # Live settings production: api_username: "XXXXXXXXXXXXXXXXXXXXXXXXXXX" api_password: "XXXXXXXXXXXXXXXX" api_signature: "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" # Don't turn this on in production mode unless you absolutely have to. It'll log people's credit card information wiredump: false # Common setting # NOTE: This file is already provided for you. You don't need to download it again. ca_file: "certs/api_cert_chain.crt"
Set session store secret Edit config/environment.rb and modify the config.action_controller.session setting
- Install Postgresql or MySQL if you haven't
- Create the store_development database. Make sure to set the encoding of the database to UTF8. I recommend pgAdmin for Postgresql newcomers.
- Edit config/database.yml
- run "rake db:migrate" to create the database schema
Replace the default license key generator in lib/licensekey.rb with your own
If you are setting up Google Checkout, log into your Google Checkout account (sandbox or live), go to Settings->Integration and put in your URL that corresponds to the following:
That is the URL that Google uses to make callbacks. If you don't set this up, your customers will not get their orders delivered by email.
gem install ruby-debug
- Put 'debugger' where you want to break in your source code
- Start the app with
rails s --debuggerto enable breakpoints
I'd appreciate it if you kept the "Powered by Potion Store" link in the footer. It'll help more developers find the project.