open_conference_ware 1.0.0.pre1

data/app/helpers/open_conference_ware/authentications_helper.rb

@@ -0,0 +1,25 @@
+module OpenConferenceWare
+  module AuthenticationsHelper
+    def auth_path(provider)
+      "#{OmniAuth.config.path_prefix}/#{provider}"
+    end
+
+    def auth_callback_path(provider)
+      "#{OmniAuth.config.path_prefix}/#{provider}/callback"
+    end
+
+    def grouped_auth_providers
+      @grouped_auth_providers ||= OpenConferenceWare.auth_providers.group_by do |provider|
+        lookup_context.find_all("open_conference_ware/authentications/_#{provider}").any? ? :with_partials : :without_partials
+      end
+    end
+
+    def auth_providers_with_partials
+      grouped_auth_providers[:with_partials]
+    end
+
+    def auth_providers_without_partials
+      grouped_auth_providers[:without_partials]
+    end
+  end
+end

data/app/helpers/open_conference_ware/cache_if_helper.rb

@@ -0,0 +1,13 @@
+module OpenConferenceWare
+  module CacheIfHelper
+    # Caches +block+ in view only if the +condition+ is true.
+    # http://skionrails.wordpress.com/2008/05/22/conditional-fragment-caching/
+    def cache_if(condition, name={}, &block)
+      if condition
+        cache(name, &block)
+      else
+        block.call
+      end
+    end
+  end
+end

data/app/helpers/open_conference_ware/display_link_to_helper.rb

@@ -0,0 +1,25 @@
+module OpenConferenceWare
+  module DisplayLinkToHelper
+
+    # Return a #link_to for a +url+ that's been sanitized by #h, had its text
+    # truncated, and optionally has the 'rel="nofollow"' flag set.
+    #
+    # Options:
+    # * maxlength: Maximum length of the displayed URL. Defaults to 64.
+    # * nofollow: Include a 'rel="nofollow"' in link to discourage spammers. Defaults to true.
+    # * mailto: The URL is an email address and should be rendered as a mailto link.
+    # * title: Title to give link, else URL.
+    def display_link_to(url, opts={})
+      opts.symbolize_keys!.reverse_merge!({
+        maxlength: 64,
+        nofollow: true,
+        mailto: false
+      })
+      link_to_opts = {}
+      link_to_opts[:rel] = "nofollow" if opts[:nofollow]
+      truncated_url = truncate(url, length: opts[:maxlength])
+      url = "mailto:#{url}" if opts[:mailto];
+      return link_to(h(opts[:title] || truncated_url), h(url), link_to_opts)
+    end
+  end
+end

data/app/helpers/open_conference_ware/display_textile_for_helper.rb

@@ -0,0 +1,11 @@
+module OpenConferenceWare
+  module DisplayTextileForHelper
+    def display_textile_for(text)
+      return auto_link(textilize(sanitize(text || "")).html_safe, :all, rel: 'nofollow').html_safe
+    end
+
+    def display_textile_help_link
+      return link_to('Formatting', 'http://redcloth.org/hobix.com/textile/', target: "_blank")
+    end
+  end
+end

data/app/helpers/open_conference_ware/field_annotation_helper.rb

@@ -0,0 +1,11 @@
+module OpenConferenceWare
+  module FieldAnnotationHelper
+    def required_field
+      content_tag :span, "*", class: "required-field"
+    end
+
+    def private_field
+      content_tag :span, "%", class: "private-field"
+    end
+  end
+end

data/app/helpers/open_conference_ware/focus_helper.rb

@@ -0,0 +1,16 @@
+module OpenConferenceWare
+  module FocusHelper
+
+    # Focus the form input on the +target+ id element.
+    def focus(target)
+      # # Plain JavaScript
+      #     content_for :javascript, <<-HERE
+      # document.getElementById('#{target}').focus();
+      #     HERE
+
+      # jQuery
+      run_when_dom_is_ready "$('##{h target.to_s}').focus();"
+    end
+
+  end
+end

data/app/helpers/open_conference_ware/localcss_helper.rb

@@ -0,0 +1,10 @@
+module OpenConferenceWare
+  module LocalcssHelper
+    # Use local CSS files? These are used if the server is running the
+    # "development" environment, or if there is a "localcss.flag" file, or the
+    # LOCALCSS environmental variable is set.
+    def localcss?
+      return Rails.env == "development" || ENV['LOCALCSS'] || File.exist?(File.join(Rails.root, "localcss.flag"))
+    end
+  end
+end

data/app/helpers/open_conference_ware/page_title_helper.rb

@@ -0,0 +1,17 @@
+module OpenConferenceWare
+  # = PageTitleHelper
+  #
+  # This mixin provides a #page_title helper for easily getting/setting the
+  # page's title, and providing a reasonable title if none was set.
+  module PageTitleHelper
+
+    # Return string to be used as a page title (e.g., for HTML's TITLE and H1).
+    # If +value+ provided, also sets page title. If no page title was set,
+    # provides a reasonable simulation based on the controller's name and action.
+    def page_title(value=nil)
+      @_page_title = value if value
+      return(@_page_title || "#{controller.controller_name.humanize}: #{action_name.humanize}")
+    end
+
+  end
+end

data/app/helpers/open_conference_ware/proposals_helper.rb

@@ -0,0 +1,54 @@
+module OpenConferenceWare
+  module ProposalsHelper
+    # Return link with a +label+ for sorting records by +field+. The optional
+    # +kind+ (e.g., :sessions or :proposals) determines what URLs to generate, if
+    # one isn't specified, then the @kind instance variable will be used.
+    def sort_link_for(label, field, kind=nil)
+      kind ||= @kind
+
+      opts = {sort: field}
+      opts[:dir] = 'desc' if ( field == params[:sort] && params[:dir] != 'desc' )
+
+      link = link_to(label, self.send("event_#{kind}_path", @event, opts))
+      link += ( params[:dir] == 'desc' ? ' ∨' : ' ∧' ).html_safe if field == params[:sort]
+
+      return link
+    end
+
+    # Return a link path for the given +object+. The optional +kind+ (e.g.,
+    # :sessions or :proposals) determines what kind of links to make, if one
+    # isn't specified, then the @kind instance variable will be used.
+    def record_path(object, kind=nil)
+      kind ||= @kind
+      raise ArgumentError, "No kind or @kind specified" unless kind
+      kind = kind.to_s.singularize
+      return self.send("#{kind}_path", object)
+    end
+
+    # Return a link path for the collection. The optional +kind+ (e.g.,
+    # :sessions or :proposals) determines what kind of links to make, if one
+    # isn't specified, then the @kind instance variable will be used.
+    def records_path(kind=nil)
+      kind = (kind || @kind).to_s.pluralize
+      return self.send("event_#{kind}_path", @event)
+    end
+
+    # Return a path to the next proposal after +proposal+. Or none if none.
+    def next_proposal_path_from(proposal)
+      if next_proposal = proposal.next_proposal
+        return proposal_path(next_proposal)
+      else
+        return nil
+      end
+    end
+
+    # Return a path to the previous proposal after +proposal+. Or none if none.
+    def previous_proposal_path_from(proposal)
+      if previous_proposal = proposal.previous_proposal
+        return proposal_path(previous_proposal)
+      else
+        return nil
+      end
+    end
+  end
+end

data/app/helpers/open_conference_ware/rooms_helper.rb

@@ -0,0 +1,5 @@
+module OpenConferenceWare
+  module RoomsHelper
+    include FauxRoutesMixin
+  end
+end

data/app/helpers/open_conference_ware/scroll_to_helper.rb

@@ -0,0 +1,15 @@
+module OpenConferenceWare
+  module ScrollToHelper
+    # Scroll the window with jQuery to the target selection.
+    #
+    # To an id:
+    #
+    #   <% scroll_to '#event_open_text' %>
+    #
+    # To a query:
+    #   <% scroll_to 'label[for=event_open_text]' %>
+    def scroll_to(target)
+      run_when_dom_is_ready "$('html,body').animate({scrollTop: $('#{h target.to_s}').offset().top},'slow');"
+    end
+  end
+end

data/app/helpers/open_conference_ware/session_types_helper.rb

@@ -0,0 +1,5 @@
+module OpenConferenceWare
+  module SessionTypesHelper
+    include FauxRoutesMixin
+  end
+end

data/app/helpers/open_conference_ware/snippets_helper.rb

@@ -0,0 +1,36 @@
+module OpenConferenceWare
+  # SnippetsHelper retrieves Snippet records and contents for views.
+  module SnippetsHelper
+    # Return the Snippet record matching the +slug+, else raise a
+    # ActiveRecord::RecordNotFound.
+    def snippet_record_for(slug)
+      if record = Snippet.lookup(slug.to_s)
+        return record
+      else
+        raise ActiveRecord::RecordNotFound, "Can't find snippet: #{slug}"
+      end
+    end
+
+    # Return the raw snippet content for a +slug+, else raises a
+    # ActiveRecord::RecordNotFound.
+    def raw_snippet_for(slug)
+      snippet_record_for(slug).content
+    end
+
+    # Returns the snippet content adorned with an "Edit" link if the user is an
+    # admin, the raw content if the user is a mortal, else raises a
+    # ActiveRecord::RecordNotFound.
+    def snippet_for(slug, use_simple_format=true)
+      record = snippet_record_for(slug)
+      string = record.content
+      if admin?
+        if matcher = string.match(%r{(.+)(</(?:div|p)>)\s*$}s)
+          string = matcher[1] + link_to("Edit", edit_manage_snippet_path(record), class: :snippet_edit_link) + matcher[2]
+        else
+          string = string + link_to("Edit", edit_manage_snippet_path(record), class: :snippet_edit_link)
+        end
+      end
+      return use_simple_format ? simple_format(string) : string
+    end
+  end
+end

data/app/helpers/open_conference_ware/time_range_helper.rb

@@ -0,0 +1,198 @@
+module OpenConferenceWare
+  module TimeRangeHelper
+    def normalize_time(start_time, end_time=nil, opts=nil)
+      TimeRange.new(start_time, end_time, opts).to_s
+      # datetime_format(time,time.min == 0 ? '%I%p' : '%I:%M%p').downcase
+    end
+  end
+
+  class TimeRange
+    # A representation of a time or range of time that can format itself
+    # in a meaningful way. Examples:
+    # "Thursday, April 3, 2008"
+    # "Thursday, April 3, 2008 at 4pm"
+    # "Thursday, April 3, 2008 from 4:30-6pm"
+    # (context: in the list for today) "11:30am-2pm"
+    # "Thursday-Friday, April 3-5, 2008"
+    # (context: during 2008) "Thursday April 5, 2009 at 3:30pm through Friday, April 5 at 8:45pm, 2009"
+    # (same, context: during 2009) "Thursday April 5 at 3:30pm through Friday, April 5 at 8:45pm"
+    
+    @@to_s_cache = {}
+
+    def initialize(start_time, end_time=nil, opts=nil)
+      # Initialize with a single DateTime, a pair of DateTimes,
+      # or an object that responds_to start_time and end_time, and
+      # several options
+      #
+      # By default (unless format: :text) include <abbr> tags
+      # for hCalendar, and (unless relative: false) refer to
+      # "today", "yesterday", and "tomorrow" using those labels;
+      # if a :context date is provided, omit unnecessary date parts.
+      if end_time.is_a? Hash
+        opts = end_time
+        end_time = nil
+      else
+        opts ||= {}
+      end
+      if end_time.nil? and start_time.respond_to?(:start_time)
+        @start_time = start_time.start_time
+        @end_time = start_time.end_time
+      else
+        @start_time = start_time
+        @end_time = end_time
+      end
+      @format = opts[:format] || :hcal
+      @relative = opts[:relative] || false
+      @context_date = opts[:context]
+    end
+
+    def cache_key
+      return [@start_time, @end_time, @format, @relative, @context_date].hash
+    end
+
+    def to_s
+      return @@to_s_cache[cache_key] ||= self.to_s_raw.html_safe
+    end
+
+    def to_s_raw
+      # Assume one date only, equal start/end
+      start_format_list = [nil, :wday, :month, :day, :year, :at, :hour, :min, :suffix, nil]
+
+      start_details = time_details(@start_time)
+      if @end_time.nil? or @start_time == @end_time
+        # One date only, or equal dates.
+        end_format_list = conjunction = nil
+      else
+        end_details = time_details(@end_time)
+        if @start_time.to_date == @end_time.to_date
+          start_format_list[start_format_list.index(:at)] = :from
+          conjunction = @format == :text ? " - " : " &ndash; "
+          if start_details[:suffix] == end_details[:suffix]
+            # same day & am/pm
+            # Tuesday, April 1, 2008 from 9-11am
+            start_format_list.delete(:suffix)
+            end_format_list = [nil, :hour, :min, :suffix, nil]
+          else
+            # same day, different am/pm
+            # Tuesday, April 1, 2008 from 9am-1:30pm
+            end_format_list = [nil, :hour, :min, :suffix, nil]
+          end
+        else
+          # different days:
+          # Tuesday, April 1, 2008 at 9am through Wednesday, April 1, 2009 at 1:30pm
+          end_format_list = start_format_list.clone
+          conjunction = " through "
+        end
+      end
+
+      # Remove stuff implied by our context
+      if @context_date
+        # Do it to both start & end lists
+        [[@start_time, start_format_list], [@end_time, end_format_list]].each do |t, list|
+          if t and list
+            list.delete(:year) if @context_date.year == t.year # same year
+            [:wday, :month, :day, :at, :from].each do |k|
+              list.delete(k)
+            end if @context_date == t.to_date
+          end
+        end
+      end
+
+      # Combine the pieces
+      results = []
+      results << %Q|<abbr class="dtstart" title="#{@start_time.strftime('%Y-%m-%dT%H:%M:%S')}">| if @format == :hcal
+      results << format_details_by_list(start_details, start_format_list)
+      results << %Q|</abbr>| if @format == :hcal
+      if end_format_list
+        results << conjunction
+        results << %Q|<abbr class="dtend" title="#{@end_time.strftime('%Y-%m-%dT%H:%M:%S')}">| if @format == :hcal
+        results << format_details_by_list(end_details, end_format_list)
+        results << %Q|</abbr>| if @format == :hcal
+      end
+      results.join
+    end
+
+  protected
+
+    PREFIXES = {
+      hour: " ",
+      [nil, :hour] => "",
+      year: ", ",
+      end_hour: " ",
+      end_year: ", ",
+    }
+    SUFFIXES = {
+      month: " ",
+      wday: ", ",
+    }
+    STRINGS = {
+      from: " from",
+      at: " at",
+    }
+
+    def format_details_by_list(details, format_list)
+      # Given a hash of date details, and a format_list of the keys
+      # that should be emitted, produce a list of the pieces.
+      #
+      # Include any extra pieces implied by juxtaposition: eg,
+      # if PREFIXES[:hour] is " ", include a " " piece just
+      # before the hour, unless nil immediately
+      # preceded :hour and we have a PREFIXES[[nil, :hour]], in
+      # which case we'll emit that instead.
+      results = []
+      format_list.each_cons(3) do |before, part, after|
+        results << (PREFIXES[[before, part]] || PREFIXES[part])
+        results << (details[part] || STRINGS[part])
+        results << (SUFFIXES[[part, after]] || SUFFIXES[part])
+      end
+      results
+    end
+
+    def date_details(d)
+      # Get the parts for formatting a date, as a hash of
+      # strings: keys (roughly) match the equivalent methods on Date, but only
+      # relevant keys will be filled in. If relative is true (the default):
+      # - if it's today, tomorrow, or yesterday, :wday will be eg "today"
+      #   (with no other date fields)
+      case @relative && d.to_date - Date.today
+        when 1
+          { wday: "tomorrow" }
+        when 0
+          { wday: "today" }
+        when -1
+          { wday: "yesterday" }
+        else
+          { wday: Date::DAYNAMES[d.wday],
+            month: Date::MONTHNAMES[d.month],
+            day: d.day.to_s,
+            year: d.year.to_s }
+      end
+    end
+
+    def time_details(t)
+      # Get the parts for formatting this time, as a hash of
+      # strings: keys (roughly) match the equivalent methods on DateTime, but only
+      # relevant keys will be filled in. If relative is true (the default):
+      # - if it's today, tomorrow, or yesterday, :wday will be eg "today"
+      #   (with no other date fields)
+      # - if it's exactly noon or midnight, :hour will be eg "noon"
+      #   (with no other time fields)
+      details = date_details(t)
+      if t.min == 0
+        return details.merge(hour: "Midnight") if t.hour == 0
+        return details.merge(hour: "Noon") if t.hour == 12
+      end
+      if t.hour >= 12
+        suffix = "pm"
+        h = t.hour - (t.hour > 12 ? 12 : 0)
+      else
+        suffix = "am"
+        h = t.hour == 0 ? 12 : t.hour
+      end
+      m = ":%02d" % t.min
+      details.merge(hour: h.to_s,
+                    min: m,
+                    suffix: suffix)
+    end
+  end
+end