versacommerce_app 1.0.17

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a2a7f4d54e37905ba1e19d57a2ef5a907b988073
+  data.tar.gz: 4d3590c5b311ad9a259b9be92f87c521c0e120f1
+SHA512:
+  metadata.gz: 4f566827b163e6736531db2f8e25fe95cb763215671485556c2def3643059d01950eda0209b95db3e6e2fcef76e23f3b831a69a336b76e5f13bd3958dffc26f8
+  data.tar.gz: e716a95df6f8491922f4cb57b9d69813ab925bab4c7231ad5773aa29008aed6e3b94abafad5a329d6ac17dd6b54f80938c80d345e2d6db4ed5e221268a921d74

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+*.swp
+.bundle
+.DS_Store
+.rvmrc
+/coverage
+Gemfile.lock

data/CHANGELOG

@@ -0,0 +1,2 @@
+1.0.5 
+1.0.0 initial version [dorra]

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in versacommerce_app.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2013 VersaCommerce 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,68 @@
+# VersaCommerce App Generator
+
+VersaCommerce application generator for Rails 3.1 and Rails 4.0
+
+## Description
+
+This gem makes it easy to get a Rails 3.1 or Rails 4.0 app up and running with the VersaCommerce API.
+
+The generator creates a basic SessionsController for authenticating with your shop and a HomeController which displays basic information about your products, orders and the shop itself.
+
+*Note: It's recommended to use this on a new Rails project, so that the generator won't overwrite/delete some of your files.*
+
+## Installation
+
+``` sh
+# Create a new rails app
+$ rails new my_versacommerce_app
+$ cd my_versacommerce_app
+
+# Add the gem versacommerce_app to your Gemfile
+$ echo "gem 'versacommerce_app'" >> Gemfile
+$ bundle install
+```
+
+## Usage
+
+``` sh
+$ rails generate versacommerce_app your_app_api_key your_app_secret
+```
+
+### Example
+
+``` sh
+$ rails generate versacommerce_app aabbcc1122334455667788 gghhhiijjkk998877665544
+```
+
+This will create a SessionsController and HomeController with their own views.
+
+## Configuring VersaCommerce App
+
+It's possible to set your API key and secret key from different sources:
+
+* Configuration in a Rails `<environment>.rb` config file
+
+``` ruby
+config.versacommerce.api_key = 'your api key'
+config.versacommerce.secret = 'your secret'
+```
+
+* Configuration loaded from `<environment>` key in `versacommerce_app.yml`
+
+``` yaml
+development:
+  api_key: your api key
+  secret: your secret
+```
+
+## Next...
+
+Start your application:
+
+``` sh
+$ rails server
+```
+
+Now visit http://localhost:3000 and register (install) your application with a VersaCommerce store. Even if Rails tells you to visit your app at http://0.0.0.0:3000, go to http://localhost:3000.
+
+After your application has been given whatever API permissions, you're ready to start experimenting with the VersaCommerce API. Have Fun :)

data/Rakefile

@@ -0,0 +1,13 @@
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+
+Bundler::GemHelper.install_tasks
+
+Rake::TestTask.new do |t|
+  t.libs << 'lib/versacommerce_app'
+  t.libs << 'test'
+  t.test_files = FileList['test/**/*_test.rb']
+  t.verbose = true
+end
+
+task :default => :test

data/install.rb

@@ -0,0 +1,20 @@
+puts
+puts "VERSACOMMERCE APP GENERATOR"
+puts 
+puts "Every app needs to:"
+puts 
+puts "1. Registered with VersaCommerce. You will receive an APP_KEY and a shared secret."
+puts "2. Registered with a Shop. This will provide a token."
+puts
+puts
+puts "To get going, register your app with VersaCommerce:"
+puts
+puts " - Send an E-Mail to support@versacommerce.de, we will get in touch with you immediately."
+puts
+puts " * Now run the generator:"
+puts
+puts "   $ rails generate versacommerce_app API_KEY SHARED_SECRET"
+puts
+puts "   $ rails server"
+puts
+puts " * Visit http://localhost:3000 and use a shop URL to install this app."

data/lib/generators/versacommerce_app/README

@@ -0,0 +1,15 @@
+
+What's next?
+------------
+
+Start your application with:
+
+  $ rails server
+
+Now visit http://localhost:3000 and register (install) your application with a VersaCommerce store.
+
+After your application has been given read or read/write API permission by the
+shop, you're ready to start experimenting with the VersaCommerce API.
+
+
+API Reference     https://github.com/versacommerce/vc-api

data/lib/generators/versacommerce_app/USAGE

@@ -0,0 +1,21 @@
+Description:
+    This is a generator for creating a basic VersaCommerce application to quickly get
+    you started. You can see some examples on how to use the VersaCommerce API.
+    
+    The generator creates a basic sessions controller for authenticating with your
+    Shop and a controller called "home" which displays basic information 
+    about your products, orders and articles.
+    
+    Note: It's recommended to use this on a new Rails project, so that the 
+          generator won't overwrite/delete some of your files.
+
+Usage:
+    Pass your API key and then your Secret, which the sessions controller 
+    will need to authenticate with your shop. 
+    If you don't have an API key yet, register your application with us.
+
+    
+Examples:
+    rails/generate versacommerce_app aabbccddeee112233445566 ppooiikkkhh99887...
+        
+    This will create a sessions controller and a home controller and views.

data/lib/generators/versacommerce_app/templates/app/controllers/home_controller.rb

@@ -0,0 +1,13 @@
+# -*- encoding : utf-8 -*-
+class HomeController < ApplicationController
+  around_filter :ensure_current_api_session
+    
+  def index
+    # get 10 products
+    @products = VersacommerceAPI::Product.find(:all, :params => {:limit => 10})
+
+    # get latest 5 orders
+    @orders   = VersacommerceAPI::Order.find(:all, :params => {:limit => 5, :order => "created_at DESC" })
+  end
+  
+end

data/lib/generators/versacommerce_app/templates/app/controllers/sessions_controller.rb

@@ -0,0 +1,68 @@
+# -*- encoding : utf-8 -*-
+class SessionsController < ApplicationController
+
+  def new
+    authenticate if params[:shop].present?
+  end
+
+  def create
+    authenticate
+  end
+    
+  def destroy
+    session[:versacommerce] = nil
+    flash[:success]         = "Successfully logged out."
+    redirect_to :action => 'new'
+  end
+  
+  def finalize
+    current_session = VersacommerceAPI::Session.new(params[:shop], params[:t], params)
+    if current_session.valid?
+      #
+      # IF YOU WANT TO SAVE THE TOKEN FOR LATER USE,
+      #
+      # 1) CREATE A MODEL
+      # $ rails generate model user shop:string token:string
+      # $ rake db:create && rake db:migrate
+      #
+      # 2) SAVE THE TOKEN RIGHT HERE
+      # User.where(shop: params[:shop]).first_or_create do |user|
+      #   user.token = params[:t]
+      # end
+      #
+      # 3) USE THE TOKEN TO CONNECT TO THIS SHOP WITHOUT USER INTERACTION
+      # https://github.com/versacommerce/versacommerce_api (see sample code)
+      #
+      session[:versacommerce] = current_session
+      flash[:success]         = "Connection established to: #{params[:shop]}"
+      redirect_to return_address
+    else
+      flash[:warning] = "Connection failed."
+      redirect_to :action => 'index'
+    end
+  end
+  
+  protected
+  
+  def authenticate
+    if shop_name = sanitize_shop_param(params)
+      redirect_to VersacommerceAPI::Session.new(shop_name).create_permission_url
+    else
+      redirect_to return_address
+    end
+  end
+  
+  def return_address
+    session[:return_to] || root_url
+  end
+  
+  def sanitize_shop_param(params)
+    return unless params[:shop].present?
+    name = params[:shop].to_s.strip
+    name += '.versacommerce.de' if !name.include?("versacommerce.de") && !name.include?(".")
+    name.sub('https://', '').sub('http://', '')
+    u = URI("http://#{name}")
+    u.host.ends_with?("versacommerce.de") ? u.host : nil
+  end
+
+end

data/lib/generators/versacommerce_app/templates/app/helpers/home_helper.rb

@@ -0,0 +1,4 @@
+# -*- encoding : utf-8 -*-
+module HomeHelper
+
+end

data/lib/generators/versacommerce_app/templates/app/helpers/sessions_helper.rb

@@ -0,0 +1,4 @@
+# -*- encoding : utf-8 -*-
+module SessionsHelper  
+  
+end

data/lib/generators/versacommerce_app/templates/app/views/home/index.html.erb

@@ -0,0 +1,161 @@
+<div class="page-header">
+  <h1>How does this work?</h1>
+</div>
+<p class="lead">
+  This is the VersaCommerce App Template build on <a href="http://getbootstrap.com" target="_blank">Bootstrap 3</a>.
+  To get the ball rolling: It uses the <a href="https://github.com/versacommerce/versacommerce_api" target="_blank">VersaCommerce API GEM</a> for accessing the VersaCommerce admin REST web services. It is build with the <a href="https://github.com/versacommerce/versacommerce_app" target="_blank">versacommerce_app generator</a> which provides a <a href="https://github.com/versacommerce/versacommerce_app/blob/master/lib/versacommerce_app/ensure_api_session.rb" target="_blank">module</a> to ensure the API-Session.
+</p>
+
+
+<div class="panel panel-default">
+  <div class="panel-heading">
+    <h3 class="panel-title">Check out the code</h3>
+  </div>
+  <div class="panel-body">
+    <p>
+      <p><strong>Check out the</strong> <code>home_controller</code></p>
+      <p>The controller in this demo application fetches the newest 5 orders and products and makes them available as instance variables <code>@orders</code> and <code>@products</code></p>
+    </p>
+    <p>
+      <p><strong>Take a look at</strong> <code>index.html.erb</code></p>
+      <p>Index is the Ruby template you are currently viewing. Have a look at the markup and Ruby code to see how the VersaCommerce API is being used. It's located at <code>views/home/index.html.erb</code></p>
+    </p>
+    <p>
+      <p><strong>Check out the</strong> <code>sessions_controller</code></p>
+      <p>The sessions-controller in this demo application makes sure, you are connected to a VersaCommerce Shop. If not, it asks you to register (install) your app with a shop. After authorisation it calls the action <code>sessions#finalize</code>. If you want to store the &quot;registration-token&quot; <code>token</code> for unattended usage, you can place your code right here.</p>
+    </p>
+  </div>
+</div>
+
+
+<div class="panel panel-default">
+  <div class="panel-heading">
+    <h3 class="panel-title">Additional Documentation</h3>
+  </div>
+  <div class="panel-body">
+    <p>
+      <%= link_to 'API documentation', 'https://github.com/versacommerce/vc-api' %><br/>
+      <span class="note">Learn what you can do with the VersaCommerce API</span>
+    </p>
+    <p>
+      <%= link_to 'Bootstrap documentation', 'http://twitter.github.com/bootstrap/' %><br/>
+      <span class="note">Find out what you can do with Twitter Bootstrap</span>
+    </p>
+  </div>
+</div>
+
+
+<div class="panel panel-default">
+  <div class="panel-heading">
+    <h3 class="panel-title">About this Shop</h3>
+  </div>
+  <div class="panel-body">
+    <p>
+      <p><strong>Name</strong></p>
+      <p><%= current_shop.shop.name %></p>
+    </p>
+    <p>
+      <p><strong>URL</strong></p>
+      <p><%= current_shop.shop.url %></p>
+    </p>
+    <p>
+      <p><strong>Price includes tax</strong></p>
+      <p><%= current_shop.shop.price_includes_tax%></p>
+    </p>
+    <p>
+      <p><strong>Currency</strong></p>
+      <p><%= current_shop.shop.currency_code%></p>
+    </p>
+  </div>
+</div>
+
+
+<div class="panel panel-default">
+  <div class="panel-heading">
+    <h3 class="panel-title">Recent Orders</h3>
+  </div>
+  <div class="panel-body">
+
+    <% if @orders.blank? %>
+      <table class="table table-striped">
+        <tr>
+          <td><em>There are no orders in your shop.</em></td>
+        </tr>
+      </table>
+    <% else %>
+      <table class="table table-striped">
+        <thead>
+          <tr>
+            <th>Order</th>
+            <th>Customer</th>
+            <th>Status</th>
+            <th>Total</th>
+          </tr>
+        </thead>
+      <% @orders.each do |order| %>
+        <tr>
+          <td><%= link_to order.code, "https://#{current_shop.url}/admin/orders/#{order.id}", :target => 'blank' %></td>
+          <td><%= "#{order.billing_address.firstname} #{order.billing_address.lastname}" %></td>
+          <td>
+            <%= order.status %>
+          </td>
+          <td><%= order.total %> <%= order.currency %></td>
+        </tr>
+      <% end %>
+      </table>
+    <% end %>
+
+  </div>
+</div>
+
+
+<h4>New Products</h4>
+  
+<% if @products.blank? %>
+
+  <div class="panel-group">
+    <div class="panel-heading">
+      <em>There are no products in your shop.</em>
+    </div>
+  </div>
+
+<% else %>
+
+  <div class="accordion" id="accordion">      
+    <div class="panel-group">
+
+      <%  @products.each_with_index do |product, index| %>
+        <div class="panel panel-default">
+
+          <div class="panel-heading">
+            <h4 class="panel-title">
+              <a class="accordion-toggle" data-toggle="collapse" data-parent="#accordion" href="#collapse<%= product.id %>">
+                <%= product.title %>
+              </a>
+              <span class="pull-right muted"><%= product.price %> <%= current_shop.shop.currency_code %></span>
+            </h4>
+          </div>
+  
+          <div id="collapse<%= product.id %>" class="panel-body collapse <% if index == 0 %>in<% end %>">
+            <div class="panel-body">
+              <%= image_tag( product.featured_image.medium, class: "pull-right" ) unless product.featured_image_url.blank? %>                
+              <p><strong>SKU:</strong> <%= product.code %></p>
+              <p><strong>Category:</strong> <%= product.category %></p>
+              <p><strong>Vendor:</strong> <%= product.vendor %></p>
+              <%= raw(product.description_html) %>
+              <br/>
+              <p class="muted">Created at <%= product.created_on.strftime("%Y-%m-%d") %></p>
+              <br/>
+              <%= link_to "Open this product in /admin", "http://#{current_shop.url}/admin/catalog/products/#{product.id}/edit", :target => 'blank', class: "btn btn-default" %>
+            </div>
+          </div>
+
+        </div>
+      <% end %>
+
+    </div>
+
+  </div>
+<% end %>
+
+<br/><br/>

data/lib/generators/versacommerce_app/templates/app/views/layouts/application.html.erb

@@ -0,0 +1,129 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="description" content="">
+    <meta name="author" content="">
+    <link rel="shortcut icon" href="../assets/favicon.png">
+    <link rel="apple-touch-icon" href="../assets/versacommerce-57.png">
+    <link rel="apple-touch-icon" sizes="72x72" href="../assets/versacommerce-72.png">
+    <link rel="apple-touch-icon" sizes="114x114" href="../assets/versacommerce-114.png">
+
+    <title>VersaCommerce Sample App</title>
+
+    <!-- Bootstrap core CSS -->
+    <link href="//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css" rel="stylesheet">
+
+    <%= stylesheet_link_tag 'application' %>
+
+    <style type="text/css" media="screen">
+      /* Sticky footer styles
+      -------------------------------------------------- */
+
+      html,
+      body {
+        height: 100%;
+        /* The html and body elements cannot have any padding or margin. */
+      }
+
+      /* Wrapper for page content to push down footer */
+      #wrap {
+        min-height: 100%;
+        height: auto !important;
+        height: 100%;
+        /* Negative indent footer by its height */
+        margin: 0 auto -60px;
+        /* Pad bottom by footer height */
+        padding: 0 0 60px;
+      }
+
+      /* Set the fixed height of the footer here */
+      #footer {
+        height: 60px;
+        background-color: #f5f5f5;
+      }
+
+
+      /* Custom page CSS
+      -------------------------------------------------- */
+
+      #wrap > .container {
+        padding: 60px 15px 0;
+      }
+      .container .credit {
+        margin: 20px 0;
+      }
+
+      #footer > .container {
+        padding-left: 15px;
+        padding-right: 15px;
+      }
+
+      code {
+        font-size: 80%;
+      }
+    </style>
+
+    <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+      <!-- <script src="../../assets/js/respond.min.js"></script> -->
+    <![endif]-->
+    <%= csrf_meta_tags %>
+  </head>
+
+  <body>
+
+    <!-- Wrap all page content here -->
+    <div id="wrap">
+      <!-- Fixed navbar -->
+      <div class="navbar navbar-default navbar-fixed-top">
+        <div class="container">
+          <div class="navbar-header">
+            <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">
+              <span class="icon-bar"></span>
+              <span class="icon-bar"></span>
+              <span class="icon-bar"></span>
+            </button>
+            <%= link_to 'VersaCommerce App', '/', :class => 'navbar-brand' %>
+          </div>
+          <% if current_shop %>
+          <div class="collapse navbar-collapse">
+            <ul class="nav navbar-nav">
+              <li><a href="https://github.com/versacommerce/vc-api" target="_blank">API Documentation</a></li>
+              <li><a href="https://github.com/versacommerce/versacommerce_api" target="_blank">API GEM</a></li>
+              <li class="dropdown">
+                <a href="#" class="dropdown-toggle" data-toggle="dropdown"><%= current_shop.url %> <b class="caret"></b></a>
+                <ul class="dropdown-menu">
+                  <li><%= link_to raw('<i class="icon-home"></i> Shop'), "http://"+current_shop.url, :target => 'blank' %></li>
+                  <li><%= link_to raw('<i class="icon-cog"></i> Admin'), "http://"+current_shop.url+"/admin", :target => 'blank' %></li>
+                  <li class="divider"></li>
+                  <li><%= link_to raw('<i class="icon-off"></i> Logout'), logout_path, :method => :delete %></li>
+                </ul>
+              </li>
+            </ul>
+          </div><!--/.nav-collapse -->
+          <% end %>
+        </div>
+      </div>
+
+      <!-- Begin page content -->
+      <div class="container">
+        <% flash.each do |type, message| %>
+          <div class="alert alert-<%= type %>"><%= message %></div>
+        <% end %>
+        <%= yield %>
+      </div>
+    </div>
+
+    <div id="footer">
+      <div class="container">
+        <p class="text-muted credit">VersaCommerce Example App. Created by <a href="http://www.versacommerce.de" target="_blank">versacommerce.de</a></p>
+      </div>
+    </div>
+
+    <%= javascript_include_tag 'application' %>
+    <script src="//netdna.bootstrapcdn.com/bootstrap/3.0.0/js/bootstrap.min.js"></script>
+  </body>
+</html>

data/lib/generators/versacommerce_app/templates/app/views/sessions/new.html.erb

@@ -0,0 +1,15 @@
+<div class="page-header" id="login-header">
+  <%= image_tag 'versacommerce-100.png', class: "pull-right", style: "opacity:.55" %>
+  <h1>Register this app with your shop.</h1>
+  <h1><small>This app requires you to login to start using it.</small></h1>
+</div>
+
+<div>
+  <%= form_tag login_path, :class => 'form-inline' do %>
+    <span class="help-block">Please enter the shop url. Example: myshop.versacommerce.de</span>
+    <div class="form-group">
+      <%= text_field_tag 'shop', nil, size: 40, :placeholder => 'myshop.versacommerce.de', :class => 'form-control' %>
+    </div>
+    <%= submit_tag 'Install / Register', :class => 'btn btn-primary btn-large' %>
+  <% end %>
+</div>

data/lib/generators/versacommerce_app/templates/public/404.html

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>404 Error: This page doesn't exist!</title>
+  
+  <style>
+  .container { text-align:center;}
+  .navbar .brand { float:none;}
+  </style>
+</head>
+
+<body>
+  <div class="navbar navbar-fixed-top">
+    <div class="navbar-inner">
+      <div class="container">
+        <a href="/" class="brand">VersaCommerce Demo App</a>
+      </div>
+    </div>
+  </div>
+  
+  <div class="container">
+    <div class="content">
+      <div class="page-header">        
+        <h1>AH! 404!</h1>
+      </div>
+
+      <h3><i class="icon-warning-sign" style="margin-top:6px; opacity:.5;"></i> Well dang, looks like this page doesn't exist.</h3>
+      <p class="muted">Well, not this one, but the one you were looking for... at least there's a kitten!</p>
+      <br/>
+      <p><img src="http://gifs.gifbin.com/122009/1259928856_surprised_kitten.gif" style="border-radius:10px;"/></p>
+      <br/>
+      <p><button type="button" value ="back" onClick="window.history.back();" class='btn btn-primary'><i class="icon-chevron-left" style="opacity:.25"></i> Back to the app</button></p>
+    </div>
+    
+    <footer>
+      <p>A VersaCommerce app by (company name here)</p>
+    </footer>
+  </div> <!-- /container -->
+</body>
+</html>

data/lib/generators/versacommerce_app/templates/public/422.html

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>422 Error: Your change was rejected</title>
+  
+  <style>
+  .container { text-align:center;}
+  .navbar .brand { float:none;}
+  </style>
+</head>
+
+<body>
+  <div class="navbar navbar-fixed-top">
+    <div class="navbar-inner">
+      <div class="container">
+        <a href="/" class="brand">VersaCommerce Demo App</a>
+      </div>
+    </div>
+  </div>
+  
+  <div class="container">
+    <div class="content">
+      
+      <div class="page-header">        
+        <h1>422 Error</h1>
+      </div>
+      
+      <h3><i class="icon-warning-sign" style="margin-top:6px; opacity:.5;"></i> Sorry, the change you requested was rejected.</h3>
+      <p class="muted">Did you try to change something you don't have access to?</p>
+      
+      <p><button type="button" value ="back" onClick="window.history.back();" class='btn btn-primary'><i class="icon-chevron-left" style="opacity:.25"></i> Back to the app</button></p>
+      
+    </div>
+    
+    <footer>
+      <p>A VersaCommerce app by (company name here)</p>
+    </footer>
+  </div> <!-- /container -->
+</body>
+</html>

data/lib/generators/versacommerce_app/templates/public/500.html

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>500 Error: Something went horribly wrong</title>
+  
+  <style>
+  .container { text-align:center;}
+  .navbar .brand { float:none;}
+  </style>
+</head>
+
+<body>
+  <div class="navbar navbar-fixed-top">
+    <div class="navbar-inner">
+      <div class="container">
+        <a href="/" class="brand">VersaCommerce Demo App</a>
+      </div>
+    </div>
+  </div>
+  
+  <div class="container">
+    <div class="content">
+      
+      <div class="page-header">        
+        <h1>AH! 500 Error!</h1>
+      </div>
+      
+      <h3><i class="icon-warning-sign" style="margin-top:6px; opacity:.5;"></i> We're sorry, but something went wrong.</h3>
+      <p class="muted">The developer of this app has been notified.</p>
+      
+      <p><button type="button" value ="back" onClick="window.history.back();" class='btn btn-primary'><i class="icon-chevron-left" style="opacity:.25"></i> Back to the app</button></p>
+      
+    </div>
+    
+    <footer>
+      <p>A VersaCommerce app by (company name here)</p>
+    </footer>
+  </div> <!-- /container -->
+</body>
+</html>

data/lib/generators/versacommerce_app/versacommerce_app_generator.rb

@@ -0,0 +1,65 @@
+# -*- encoding : utf-8 -*-
+require 'rails/generators'
+
+class VersacommerceAppGenerator < Rails::Generators::Base
+  argument :api_key, :type => :string, :required => false
+  argument :secret, :type => :string, :required => false
+  
+  class_option :skip_routes, :type => :boolean, :default => false, :desc => 'pass true to skip route generation'
+  
+  def self.source_root
+    File.join(File.dirname(__FILE__), 'templates')
+  end
+  
+  def copy_files
+    directory 'app'
+    directory 'public'
+    directory 'config'
+  end
+  
+  def remove_static_index
+    remove_file 'public/index.html'
+  end
+  
+  def add_config_variables
+    return if api_key.blank? || secret.blank?
+    
+    append_file 'config/versacommerce_api.yml', <<-DATA
+development:
+  api_key: #{api_key}
+  secret: #{secret}
+
+test:
+  api_key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+  secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+
+production:
+  api_key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+  secret: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
+    DATA
+  end
+  
+  def add_routes
+    unless options[:skip_routes]
+      route_without_newline "root :to => 'home#index'"
+      route "end"
+      route_without_newline "  delete '/logout' => :destroy"
+      route_without_newline "  post '/login' => :create"
+      route_without_newline "  get '/login' => :new"
+      route_without_newline "  get '/finalize' => :finalize"
+      route_without_newline "controller :sessions do"
+    end
+  end
+  
+  def show_readme
+    `bundle install`
+    readme '../README'
+  end
+  
+  private
+  
+  def route_without_newline(routing_code)
+    sentinel = /\.routes\.draw do(?:\s*\|map\|)?\s*$/
+    inject_into_file 'config/routes.rb', "\n  #{routing_code}", { after: sentinel, verbose: false }
+  end  
+end

data/lib/versacommerce_app/configuration.rb

@@ -0,0 +1,47 @@
+# -*- encoding : utf-8 -*-
+class VersacommerceApp::Configuration
+  VALID_KEYS = [:api_key, :secret]
+  attr_writer *VALID_KEYS
+
+  def initialize(params={})
+    self.params = default_params.merge(params)
+  end
+
+  VALID_KEYS.each do |meth|
+    define_method meth do
+      meth = meth.to_s
+      config_from_env(meth) || config_from_rails(meth) || config_from_file(meth) || ''
+    end
+  end
+
+  private
+
+  attr_accessor :params
+
+  def config_from_env(meth)
+    ENV["VERSACOMMERCE_#{meth.upcase}"]
+  end
+
+  def config_from_rails(meth)
+    instance_variable_get("@#{meth}")
+  end
+
+  def config_from_file(meth)
+    @config_file ||= load_config
+    @config_file[Rails.env].try(:[], meth) || @config_file['common'].try(:[], meth)
+  end
+
+  def load_config
+    File.exist?(config_filepath) ? YAML.load_file(config_filepath) : {}
+  end
+
+  def config_filepath
+    params[:config_file]
+  end
+
+  def default_params
+    {
+      config_file: File.join(Rails.root, 'config', 'versacommerce_api.yml')
+    }
+  end
+end

data/lib/versacommerce_app/ensure_api_session.rb

@@ -0,0 +1,33 @@
+# -*- encoding : utf-8 -*-
+module VersacommerceApp::EnsureApiSession
+  extend ActiveSupport::Concern
+  
+  included do
+    rescue_from ActiveResource::UnauthorizedAccess, :with => :close_session
+  end
+  
+  def ensure_current_api_session
+    if session[:versacommerce]
+      begin
+        VersacommerceAPI::Base.activate_session(session[:versacommerce])
+        yield
+      ensure 
+        VersacommerceAPI::Base.clear_session
+      end
+    else
+      session[:return_to] = request.fullpath if request.get?
+      redirect_to login_path(shop: params[:shop])
+    end
+  end
+  
+  def current_shop
+    session[:versacommerce]
+  end
+  
+  protected
+  
+  def close_session
+    session[versacommerce] = nil
+    redirect_to login_path
+  end
+end

data/lib/versacommerce_app/railtie.rb

@@ -0,0 +1,18 @@
+# -*- encoding : utf-8 -*-
+require 'rails'
+
+class VersacommerceApp::Railtie < ::Rails::Railtie
+
+  config.before_configuration do
+    config.versacommerce = VersacommerceApp.configuration
+  end
+  
+  initializer "versacommerce_app.action_controller_integration" do
+    ActionController::Base.send :include, VersacommerceApp::EnsureApiSession
+    ActionController::Base.send :helper_method, :current_shop
+  end
+  
+  initializer "versacommerce_app.setup_session" do
+    VersacommerceApp.setup_session
+  end
+end

data/lib/versacommerce_app/version.rb

@@ -0,0 +1,4 @@
+# -*- encoding : utf-8 -*-
+module VersacommerceApp
+  VERSION = "1.0.17"
+end

data/lib/versacommerce_app.rb

@@ -0,0 +1,18 @@
+# -*- encoding : utf-8 -*-
+require 'versacommerce_api'
+
+module VersacommerceApp
+
+  def self.configuration
+    @configuration ||= VersacommerceApp::Configuration.new
+  end
+  
+  def self.setup_session
+    VersacommerceAPI::Session.setup(:api_key => VersacommerceApp.configuration.api_key, :secret => VersacommerceApp.configuration.secret)
+  end
+end
+
+require 'versacommerce_app/ensure_api_session'
+require 'versacommerce_app/configuration'
+require 'versacommerce_app/railtie'
+require 'versacommerce_app/version'

data/versacommerce_app.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "versacommerce_app/version"
+
+Gem::Specification.new do |s|
+  s.name        = "versacommerce_app"
+  s.version     = VersacommerceApp::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.author      = "VersaCommerce"
+  s.email       = ["support@versacommerce.de"]
+  s.homepage    = "http://www.versacommerce.de"
+  s.summary     = %q{This gem is used to get quickly started with the VersaCommerce API}
+  s.description = %q{This generator creates a basic sessions controller for authenticating with your Shop. Also a home controller which lets you access your shop easily.}
+
+  s.add_runtime_dependency('rails', '>= 3.1', '< 5.0')
+  s.add_runtime_dependency('versacommerce_api', '~> 1.0.2')
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification
+name: versacommerce_app
+version: !ruby/object:Gem::Version
+  version: 1.0.17
+platform: ruby
+authors:
+- VersaCommerce
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.1'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: versacommerce_api
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.2
+description: This generator creates a basic sessions controller for authenticating
+  with your Shop. Also a home controller which lets you access your shop easily.
+email:
+- support@versacommerce.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- CHANGELOG
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- install.rb
+- lib/generators/versacommerce_app/README
+- lib/generators/versacommerce_app/USAGE
+- lib/generators/versacommerce_app/templates/app/assets/images/favicon.png
+- lib/generators/versacommerce_app/templates/app/assets/images/grid-18px.png
+- lib/generators/versacommerce_app/templates/app/assets/images/versacommerce-100.png
+- lib/generators/versacommerce_app/templates/app/assets/images/versacommerce-114.png
+- lib/generators/versacommerce_app/templates/app/assets/images/versacommerce-57.png
+- lib/generators/versacommerce_app/templates/app/assets/images/versacommerce-72.png
+- lib/generators/versacommerce_app/templates/app/controllers/home_controller.rb
+- lib/generators/versacommerce_app/templates/app/controllers/sessions_controller.rb
+- lib/generators/versacommerce_app/templates/app/helpers/home_helper.rb
+- lib/generators/versacommerce_app/templates/app/helpers/sessions_helper.rb
+- lib/generators/versacommerce_app/templates/app/views/home/index.html.erb
+- lib/generators/versacommerce_app/templates/app/views/layouts/application.html.erb
+- lib/generators/versacommerce_app/templates/app/views/sessions/new.html.erb
+- lib/generators/versacommerce_app/templates/config/versacommerce_api.yml
+- lib/generators/versacommerce_app/templates/public/404.html
+- lib/generators/versacommerce_app/templates/public/422.html
+- lib/generators/versacommerce_app/templates/public/500.html
+- lib/generators/versacommerce_app/templates/public/favicon.png
+- lib/generators/versacommerce_app/templates/public/versacommerce-114.png
+- lib/generators/versacommerce_app/templates/public/versacommerce-57.png
+- lib/generators/versacommerce_app/templates/public/versacommerce-72.png
+- lib/generators/versacommerce_app/versacommerce_app_generator.rb
+- lib/versacommerce_app.rb
+- lib/versacommerce_app/configuration.rb
+- lib/versacommerce_app/ensure_api_session.rb
+- lib/versacommerce_app/railtie.rb
+- lib/versacommerce_app/version.rb
+- versacommerce_app.gemspec
+homepage: http://www.versacommerce.de
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: This gem is used to get quickly started with the VersaCommerce API
+test_files: []