helpdesk 0.0.2

data/config/routes.rb

@@ -0,0 +1,22 @@
+Helpdesk::Engine.routes.draw do
+# Rails.application.routes.draw do
+  scope "(:locale)", :locale => /pl|en/ do
+    # Admin only roots
+    namespace :admin do
+      resources :tickets do
+        get :assign, on: :member
+      end
+      resources :ticket_types
+      resources :faqs do
+        post :sort, on: :collection
+      end
+      resources :subscribers
+      root :to => "tickets#index"
+    end
+
+    resources :faqs, :only => [ :index ]
+    resources :tickets, :except => [ :edit, :destroy ]
+    root :to => "faqs#index"
+
+  end
+end

data/db/migrate/20120420104051_create_helpdesk_tickets.rb

@@ -0,0 +1,14 @@
+class CreateHelpdeskTickets < ActiveRecord::Migration
+  def change
+    create_table :helpdesk_tickets do |t|
+      t.string :subject
+      t.text :description
+      t.integer :requester_id
+      t.integer :assignee_id
+      t.string :status
+      t.integer :ticket_type_id
+      
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20120423113938_create_helpdesk_comments.rb

@@ -0,0 +1,12 @@
+class CreateHelpdeskComments < ActiveRecord::Migration
+  def change
+    create_table :helpdesk_comments do |t|
+      t.integer :ticket_id
+      t.text :comment
+      t.integer :author_id
+      t.boolean :public
+
+      t.timestamps
+    end
+  end
+end

data/db/migrate/20130521105605_create_helpdesk_ticket_types.rb

@@ -0,0 +1,36 @@
+class CreateHelpdeskTicketTypes < ActiveRecord::Migration
+  def up
+    create_table :helpdesk_ticket_types do |t|
+      t.integer :position
+      t.boolean :active,:default=>1,:null=>false
+      t.string :tr_class
+      t.timestamps
+    end
+
+    Helpdesk::TicketType.create_translation_table! :title => :string
+
+
+    tt = [["Sugestia","Sugestion","warning"],
+          ["Pochwała","Appreciation","success"],
+          ["Błąd","Complaint","error"],
+          ["Pytanie","Enquiry","info"],
+          ["Kontakt","Contact","contact"]]
+
+    tt.each do |item|
+      I18n.locale = :pl
+      type = Helpdesk::TicketType.new
+      type.title = item[0]
+      I18n.locale = :en
+      type.title = item[1]
+      type.tr_class = item[2]
+      type.active = true
+      type.save!
+    end
+
+  end
+
+  def down
+    drop_table :helpdesk_ticket_types
+    Helpdesk::TicketType.drop_translation_table!
+  end
+end

data/db/migrate/20130522085614_create_helpdesk_faqs.rb

@@ -0,0 +1,17 @@
+class CreateHelpdeskFaqs < ActiveRecord::Migration
+  def up
+    create_table :helpdesk_faqs do |t|
+      t.integer :position
+      t.boolean :active,:default=>0,:null=>false
+
+      t.timestamps
+    end
+    Helpdesk::Faq.create_translation_table! :title => :string, :text => :text
+  end
+
+  def down
+    drop_table :helpdesk_faqs
+    Helpdesk::Faq.drop_translation_table!
+  end
+
+end

data/db/migrate/20130522090420_create_helpdesk_subscribers.rb

@@ -0,0 +1,13 @@
+class CreateHelpdeskSubscribers < ActiveRecord::Migration
+  def change
+    create_table :helpdesk_subscribers do |t|
+      t.string :name
+      t.string :email
+      t.string :lang
+      t.string :hashcode
+      t.boolean :confirmed,:default=>0,:null=>false
+      
+      t.timestamps
+    end
+  end
+end

data/lib/generators/helpdesk/install_generator.rb

@@ -0,0 +1,35 @@
+require 'securerandom'
+
+module Helpdesk
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      desc "Creates a Helpdesk initializer and copy locale files to your application."
+
+      def copy_initializer
+        template "helpdesk.rb", "config/initializers/helpdesk.rb"
+      end
+
+      def copy_locale
+        copy_file "../../../../config/locales/helpdesk.en.yml", "config/locales/helpdesk.en.yml"
+        copy_file "../../../../config/locales/helpdesk.pl.yml", "config/locales/helpdesk.pl.yml"
+      end
+
+      def run_rake
+        rake "helpdesk:install:migrations"
+        rake "db:migrate"
+      end
+
+      def add_engine_to_route
+        route "mount Helpdesk::Engine, :at => '/helpdesk'"
+      end
+
+      def show_readme
+        readme "README" if behavior == :invoke
+      end
+
+
+    end
+  end
+end

data/lib/generators/helpdesk/templates/README

@@ -0,0 +1,31 @@
+===============================================================================
+
+You need to do some manual setup to get Helpdesk working:
+
+1.  Review settings in new config/initializers/helpdesk.rb and update where
+    neccessary.
+
+2.  Add 3 methods to your applications application_controller.rb
+        * helpdesk_user - to exposes your current_user
+        * helpdesk_admin? - to check privileges
+        * helpdesk_admins_collection - to list all admin
+
+    Example, for app with devise&rolify gems:
+    application_controller.rb:
+
+        helper_method :helpdesk_user,:helpdesk_admin?,:helpdesk_admin_collection
+        def helpdesk_user
+          current_user
+        end
+
+        def helpdesk_admin?
+          current_user.has_role? :admin
+        end
+
+        def helpdesk_admin_collection
+          (Helpdesk.user_class).with_role(:admin)
+        end
+
+3.  Restart app
+
+===============================================================================

data/lib/generators/helpdesk/templates/helpdesk.rb

@@ -0,0 +1,33 @@
+require 'helpdesk'
+
+::Helpdesk.setup do |config|
+  # Class that represents the user/admin
+  config.user_class = "User"
+
+  # Method usign to display information about user for users
+  config.display_user = "name"
+
+  # Method usign to display information about user for admins (name+id?)
+  config.display_user_uniq_info = "email"
+
+  # Require User to be present in order to access Helpdesk
+  config.require_user = true
+
+  # Base application sign in route name
+  config.sign_in_url = 'new_user_session_path'
+
+  # Helpdesk email for notification
+  config.email = 'helpdesk@example.com'
+
+  # Send confirmation emails
+  config.send_confirmation_emails = true
+
+  # Site name in email footer
+  config.site_name = "Example Helpdesk Team"
+
+  # Site address in email footer
+  config.site_address = "www.example.com"
+
+  # Helpdesk title
+  config.helpdesk_name = "Example Helpdesk"
+end

data/lib/helpdesk/engine.rb

@@ -0,0 +1,29 @@
+require 'rails'
+require 'simple_form'
+require 'state_machine'
+require 'bootstrap-sass'
+require 'rails_autolink'
+require 'simple_form'
+require 'globalize'
+require 'batch_translations'
+require 'ckeditor'
+require 'chosen-rails'
+require 'kaminari'
+require 'jquery-ui-rails'
+
+module Helpdesk
+  class Engine < ::Rails::Engine
+    isolate_namespace Helpdesk
+
+    initializer "Helpdesk precompile hook" do |app|
+      app.config.assets.precompile += ['helpdesk/admin.css','helpdesk/application.css','helpdesk/application.js']
+    end
+
+    config.to_prepare do
+      if Helpdesk.user_class
+        Helpdesk.user_class.has_many :helpdesk_tickets, :class_name => "Helpdesk::Ticket", :foreign_key => "requester_id"
+        #Helpdesk.user_class.has_many :helpdesk_tickets, :class_name => "Helpdesk::Ticket", :foreign_key => "assignee_id"
+      end
+    end
+  end
+end

data/lib/helpdesk/version.rb

@@ -0,0 +1,3 @@
+module Helpdesk
+  VERSION = "0.0.2"
+end

data/lib/helpdesk.rb

@@ -0,0 +1,39 @@
+require "helpdesk/engine"
+
+module Helpdesk
+  mattr_accessor :require_user
+  @@require_user = false
+
+  mattr_accessor :sign_in_url
+
+  mattr_accessor :user_class
+
+  mattr_accessor :display_user
+
+  mattr_accessor :display_user_uniq_info
+
+  mattr_accessor :mail_server
+
+  mattr_accessor :email
+
+  mattr_accessor :send_confirmation_emails
+  @@send_confirmation_emails = false
+
+  mattr_accessor :site_name
+
+  mattr_accessor :site_address
+
+  mattr_accessor :helpdesk_name
+  @@helpdesk_name = "Helpdesk"
+
+  def self.setup
+    yield self
+  end
+
+  def self.user_class
+    if @@user_class.is_a?(String)
+      @@user_class.constantize
+    end
+  end
+
+end

data/lib/tasks/prepare_ci_env.rake

@@ -0,0 +1,27 @@
+namespace :helpdesk do
+  desc "Prepare Continuous Integration environment"
+  task :prepare_ci_env do
+    ENV['SKIP_HELPDESK_INITIALIZER'] = 'true'
+    adapter = ENV["CI_DB_ADAPTER"] || "sqlite3"
+    database = ENV["CI_DB_DATABASE"] || ("sqlite3" == adapter ? "db/development.sqlite3" : "ci_helpdesk")
+
+    configuration = {
+      "test" => {
+        "adapter" => adapter,
+        "database" => database,
+        "username" => ENV["CI_DB_USERNAME"],
+        "password" => ENV["CI_DB_PASSWORD"],
+        "host" => ENV["CI_DB_HOST"] || "localhost",
+        "encoding" => ENV["CI_DB_ENCODING"] || "utf8",
+        "pool" => (ENV["CI_DB_POOL"] || 5).to_int,
+        "timeout" => (ENV["CI_DB_TIMEOUT"] || 5000).to_int
+      }
+    }
+
+    filename = Rails.root.join("config/database.yml")
+
+    File.open(filename, "w") do |f|
+      f.write(configuration.to_yaml)
+    end
+  end
+end

data/lib/templates/erb/scaffold/_form.html.erb

@@ -0,0 +1,13 @@
+<%%= simple_form_for(@<%= singular_table_name %>) do |f| %>
+  <%%= f.error_notification %>
+
+  <div class="form-inputs">
+  <%- attributes.each do |attribute| -%>
+    <%%= f.<%= attribute.reference? ? :association : :input %> :<%= attribute.name %> %>
+  <%- end -%>
+  </div>
+
+  <div class="form-actions">
+    <%%= f.button :submit %>
+  </div>
+<%% end %>