add serverVersion callback

Author: zackchandler

README.markdown

@@ -12,7 +12,7 @@ On installation this plugin creates the following files:
 * app/controllers/qbwc_controller.rb
 * app/apis/qbwc_api.rb
 * app/helpers/qbwc_helper.rb
-* test/functional/qbwc_controller_test.rb
+* test/functional/qbwc_controller\_test.rb
 * config/qbwc.qwc
 
 The QbwcController includes a very simple example of querying QuickBooks and displaying a customer list.

install.rb

@@ -18,4 +18,4 @@ def safe_copy(src, dest)
 safe_copy File.join(plugin_root, 'templates/example_qbwc_controller_test.rb'), File.join(app_root, 'test/functional/qbwc_controller_test.rb')
 safe_copy File.join(plugin_root, 'templates/example_qbwc.qwc'), File.join(app_root, 'config/qbwc.qwc')
 
-puts IO.read(File.join(File.dirname(__FILE__), 'README'))
+puts IO.read(File.join(File.dirname(__FILE__), 'README.markdown'))

templates/example_qbwc_api.rb

@@ -1,6 +1,15 @@
 class QbwcApi < ActionWebService::API::Base
   inflect_names false
 
+  # --- [ QBWC server version control ] ---
+  # Expects:
+  #   * string ticket  = A GUID based ticket string to maintain identity of QBWebConnector 
+  # Returns string: 
+  #   * Return a string describing the server version and any other information that you want your user to see.
+  api_method :serverVersion, 
+             :expects => [{:ticket => :string}], 
+             :returns => [:string]
+             
   # --- [ QBWC version control ] ---
   # Expects:
   #   * string strVersion = QBWC version number

templates/example_qbwc_controller.rb

@@ -3,6 +3,15 @@
 class QbwcController < ApplicationController
   before_filter :set_soap_header
 
+  # --- [ QBWC server version control ] ---
+  # Expects:
+  #   * string ticket  = A GUID based ticket string to maintain identity of QBWebConnector 
+  # Returns string: 
+  #   * Return a string describing the server version and any other information that you want your user to see.
+  def serverVersion(ticket)
+    'Describe your app version here...'
+  end
+
   # --- [ QBWC version control ] ---
   # Expects:
   #   * string strVersion = QBWC version number