Class: Osm::Section

Inherits:
Model
  • Object
show all
Defined in:
lib/osm/section.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Model

#<, #<=, #>, #>=, #between?, #changed_attributes, configure, #reset_changed_attributes, #to_i

Constructor Details

#initialize ⇒ Object

Initialize a new Section

Parameters:

  • attributes (Hash) —

    The hash of attributes (see attributes for descriptions, use Symbol of attribute name as the key)




# File 'lib/osm/section.rb', line 155

Instance Attribute Details

#column_names ⇒ Hash

Returns custom names to use for the data columns.

Returns:

  • (Hash) —

    custom names to use for the data columns



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#fields ⇒ Hash

Returns which columns are shown in OSM.

Returns:

  • (Hash) —

    which columns are shown in OSM



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#flexi_records ⇒ Array<FlexiRecord>

Returns list of the extra records the section has.

Returns:

  • (Array<FlexiRecord>) —

    list of the extra records the section has



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#gocardless ⇒ Boolean

Returns does the section use gocardless.

Returns:

  • (Boolean) —

    does the section use gocardless



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#group_id ⇒ Fixnum

Returns the id for the group.

Returns:

  • (Fixnum) —

    the id for the group



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#group_name ⇒ String

Returns the group name.

Returns:

  • (String) —

    the group name



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#id ⇒ Fixnum

Returns the id for the section.

Returns:

  • (Fixnum) —

    the id for the section



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#intouch_fields ⇒ Hash

Returns which columns are shown in OSM’s in touch reports.

Returns:

  • (Hash) —

    which columns are shown in OSM’s in touch reports



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#mobile_fields ⇒ Hash

Returns which columns are shown in the OSM mobile app.

Returns:

  • (Hash) —

    which columns are shown in the OSM mobile app



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_badges ⇒ Boolean

Returns whether the section uses the Badges part of My.SCOUT.

Returns:

  • (Boolean) —

    whether the section uses the Badges part of My.SCOUT



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_badges_expires ⇒ Date

Returns when the subscription to Badges in My.SCOUT expires.

Returns:

  • (Date) —

    when the subscription to Badges in My.SCOUT expires



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_badges_partial ⇒ Boolean

Returns Wether parents can see partially completed badges.

Returns:

  • (Boolean) —

    Wether parents can see partially completed badges



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_email_address_copy ⇒ String

Returns which email address to send copys of My.SCOUT emails to.

Returns:

  • (String) —

    which email address to send copys of My.SCOUT emails to



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_email_address_from ⇒ String

Returns which email address to send My.SCOUT emails as coming from.

Returns:

  • (String) —

    which email address to send My.SCOUT emails as coming from



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_emails ⇒ Hash of Symbol to Boolean

Returns which email addresses are linked to MyScout for each Member.

Returns:

  • (Hash of Symbol to Boolean) —

    which email addresses are linked to MyScout for each Member



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_event_reminder_count ⇒ Fixnum

Returns How many event reminders to send to parents who haven’t responded.

Returns:

  • (Fixnum) —

    How many event reminders to send to parents who haven’t responded



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_event_reminder_frequency ⇒ Fixnum

Returns How many days to leave between event reminder emails.

Returns:

  • (Fixnum) —

    How many days to leave between event reminder emails



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_events ⇒ Boolean

Returns whether the section uses the Events part of My.SCOUT.

Returns:

  • (Boolean) —

    whether the section uses the Events part of My.SCOUT



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_events_expires ⇒ Date

Returns when the subscription to Events in My.SCOUT expires.

Returns:

  • (Date) —

    when the subscription to Events in My.SCOUT expires



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_payment_reminder_count ⇒ Fixnum

Returns How many payment reminders to send to parents who haven’t paid yet.

Returns:

  • (Fixnum) —

    How many payment reminders to send to parents who haven’t paid yet



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_payment_reminder_frequency ⇒ Fixnum

Returns How many days to leave between payment reminder emails.

Returns:

  • (Fixnum) —

    How many days to leave between payment reminder emails



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_payments ⇒ Boolean

Returns whether the section uses the Payments part of My.SCOUT.

Returns:

  • (Boolean) —

    whether the section uses the Payments part of My.SCOUT



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_programme ⇒ Boolean

Returns whether the section uses the Programme part of My.SCOUT.

Returns:

  • (Boolean) —

    whether the section uses the Programme part of My.SCOUT



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_programme_expires ⇒ Date

Returns when the subscription to Badges in My.SCOUT expires.

Returns:

  • (Date) —

    when the subscription to Badges in My.SCOUT expires



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_programme_summary ⇒ Boolean

Returns Wether parents can see summary of programme items.

Returns:

  • (Boolean) —

    Wether parents can see summary of programme items



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#myscout_programme_times ⇒ Boolean

Returns Wether parents can see times of programme items.

Returns:

  • (Boolean) —

    Wether parents can see times of programme items



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#name ⇒ String

Returns the section name.

Returns:

  • (String) —

    the section name



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#sms_messages_remaining ⇒ Fixnum

Returns How many SMS messages the section can send before needing to topup.

Returns:

  • (Fixnum) —

    How many SMS messages the section can send before needing to topup



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#sms_messages_sent ⇒ Fixnum

Returns How many SMS messages have been sent by the section.

Returns:

  • (Fixnum) —

    How many SMS messages have been sent by the section



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#sms_sent_test ⇒ Boolean

Returns Whether the section has sent their test SMS message.

Returns:

  • (Boolean) —

    Whether the section has sent their test SMS message



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#subscription_expires ⇒ Date

Returns when the section’s subscription to OSM expires.

Returns:

  • (Date) —

    when the section’s subscription to OSM expires



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#subscription_level ⇒ Fixnum

Returns what subscription the section has to OSM (1-bronze, 2-silver, 3-gold).

Returns:

  • (Fixnum) —

    what subscription the section has to OSM (1-bronze, 2-silver, 3-gold)



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

#type ⇒ Symbol

Returns the section type (:beavers, :cubs, :scouts, :exporers, :network, :adults, :waiting, :unknown).

Returns:

  • (Symbol) —

    the section type (:beavers, :cubs, :scouts, :exporers, :network, :adults, :waiting, :unknown)



71
 
# File 'lib/osm/section.rb', line 71

attribute :id, :type => Integer

Class Method Details

.get(api, section_id, options = {}) ⇒ Object

Get a section

Parameters:

  • api (Osm::Api) —

    The api to use to make the request

  • section_id (Fixnum) —

    The section id of the required section

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :no_cache (Boolean) — default: optional —

    if true then the data will be retreived from OSM not the cache

Returns:

  • nil if an error occured or the user does not have access to that section

  • (Osm::Section) 


258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
 
# File 'lib/osm/section.rb', line 258

def self.get(api, section_id, options={})
  cache_key = ['section', section_id]

  if !options[:no_cache] && cache_exist?(api, cache_key) && can_access_section?(api, section_id)
    return cache_read(api, cache_key)
  end

  sections = get_all(api, options)
  return nil unless sections.is_a? Array

  sections.each do |section|
    return section if section.id == section_id
  end
  return nil
end

.get_all(api, options = {}) ⇒ Array<Osm::Section>

Get the user’s sections

Parameters:

  • api (Osm::Api) —

    The api to use to make the request

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :no_cache (Boolean) — default: optional —

    if true then the data will be retreived from OSM not the cache

Returns:



164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
 
# File 'lib/osm/section.rb', line 164

def self.get_all(api, options={})
  cache_key = ['sections', api.user_id]

  if !options[:no_cache] && cache_exist?(api, cache_key)
    ids = cache_read(api, cache_key)
    return get_from_ids(api, ids, 'section', options, :get_all)
  end

  data = api.perform_query('api.php?action=getUserRoles')

  result = Array.new
  ids = Array.new
  permissions = Hash.new
  data.each do |role_data|
    unless role_data['section'].eql?('discount')  # It's not an actual section
      section_data = role_data['sectionConfig'].is_a?(String) ? ActiveSupport::JSON.decode(role_data['sectionConfig']) : role_data['sectionConfig']
      myscout_data = section_data['portal'] || {}
      section_data['portalExpires'] ||= {}
      section_id = Osm::to_i_or_nil(role_data['sectionid'])

      # Make sense of flexi records
      fr_data = []
      flexi_records = []
      fr_data = section_data['extraRecords'] if section_data['extraRecords'].is_a?(Array)
      fr_data = section_data['extraRecords'].values if section_data['extraRecords'].is_a?(Hash)
      fr_data.each do |record_data|
        # Expect item to be: {:name=>String, :extraid=>Fixnum}
        # Sometimes get item as: [String, {"name"=>String, "extraid"=>Fixnum}]
        record_data = record_data[1] if record_data.is_a?(Array)
        flexi_records.push Osm::FlexiRecord.new(
          :id => Osm::to_i_or_nil(record_data['extraid']),
          :name => record_data['name'],
          :section_id => section_id,
        )
      end

      section = new(
        :id => section_id,
        :name => role_data['sectionname'],
        :subscription_level => Osm::to_i_or_nil(section_data['subscription_level']),
        :subscription_expires => Osm::parse_date(section_data['subscription_expires']),
        :type => !section_data['sectionType'].nil? ? section_data['sectionType'].to_sym : (!section_data['section'].nil? ? section_data['section'].to_sym : :unknown),
        :num_scouts => section_data['numscouts'],
        :column_names => section_data['columnNames'].is_a?(Hash) ? Osm::symbolize_hash(section_data['columnNames']) : {},
        :fields => section_data['fields'].is_a?(Hash) ? Osm::symbolize_hash(section_data['fields']) : {},
        :intouch_fields => section_data['intouch'].is_a?(Hash) ? Osm::symbolize_hash(section_data['intouch']) : {},
        :mobile_fields => section_data['mobFields'].is_a?(Hash) ? Osm::symbolize_hash(section_data['mobFields']) : {},
        :flexi_records => flexi_records.sort,
        :group_id => role_data['groupid'],
        :group_name => role_data['groupname'],
        :gocardless => (section_data['gocardless'] || 'false').downcase.eql?('true'),
        :myscout_events_expires => Osm::parse_date(section_data['portalExpires']['events']),
        :myscout_badges_expires => Osm::parse_date(section_data['portalExpires']['badges']),
        :myscout_programme_expires => Osm::parse_date(section_data['portalExpires']['programme']),
        :myscout_events => myscout_data['events'] == 1,
        :myscout_badges => myscout_data['badges'] == 1,
        :myscout_programme => myscout_data['programme'] == 1,
        :myscout_payments => myscout_data['payments'] == 1,
        :myscout_emails => (myscout_data['emails'] || {}).inject({}) { |n,(k,v)| n[k.to_sym] = v.eql?('true'); n},
        :myscout_email_address_from => myscout_data['emailAddress'] ? myscout_data['emailAddress'] : '',
        :myscout_email_address_copy => myscout_data['emailAddressCopy'] ? myscout_data['emailAddressCopy'] : '',
        :myscout_badges_partial => myscout_data['badgesPartial'] == 1,
        :myscout_programme_summary => myscout_data['programmeSummary'] == 1,
        :myscout_programme_times => myscout_data['programmeTimes'] == 1,
        :myscout_event_reminder_count => myscout_data['eventRemindCount'].to_i,
        :myscout_event_reminder_frequency => myscout_data['eventRemindFrequency'].to_i,
        :myscout_payment_reminder_count => myscout_data['paymentRemindCount'].to_i,
        :myscout_payment_reminder_frequency => myscout_data['paymentRemindFrequency'].to_i,
        :sms_sent_test => section_data['hasSentTestSMS'],
        :sms_messages_sent => section_data['sms_sent'],
        :sms_messages_remaining => section_data['sms_remaining'],
      )

      result.push section
      ids.push section.id
      cache_write(api, ['section', section.id], section)
      permissions.merge!(section.id => Osm.make_permissions_hash(role_data['permissions']))
    end
  end

  permissions.each do |s_id, perms|
    api.set_user_permissions(s_id, perms)
  end
  cache_write(api, cache_key, ids)
  return result
end

Instance Method Details

#<=>(another) ⇒ Object

Compare Section based on group_name type (age order), then name



360
361
362
363
364
365
366
367
368
369
370
371
 
# File 'lib/osm/section.rb', line 360

def <=>(another)
  result = self.group_name <=> another.try(:group_name)
  result = 0 if self.type == another.try(:type) && result == 0
  [:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |type|
    if result == 0
      result = -1 if self.type == type
      result =  1 if another.try(:type) == type
    end
  end
  result = self.name <=> another.try(:name) if result == 0
  return result
end

#adults? ⇒ Boolean

Check if this is an Adults section

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#beavers? ⇒ Boolean

Check if this is a Beavers section

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#cubs? ⇒ Boolean

Check if this is a Cubs section

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#explorers? ⇒ Boolean

Check if this is an Explorers section

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#get_notepad(api, options = {}) ⇒ String

Get the section’s notepad from OSM

Parameters:

  • api (Osm::Api) —

    The api to use to make the request

  • options (Hash) (defaults to: {})

Options Hash (options):

  • :no_cache (Boolean) — default: optional —

    if true then the data will be retreived from OSM not the cache

Returns:

  • (String) —

    the section’s notepad



279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
 
# File 'lib/osm/section.rb', line 279

def get_notepad(api, options={})
  require_access_to_section(api, self, options)
  cache_key = ['notepad', id]

  if !options[:no_cache] && cache_exist?(api, cache_key) && can_access_section?(api, self.id)
    return cache_read(api, cache_key)
  end

  notepads = api.perform_query('api.php?action=getNotepads')
  return '' unless notepads.is_a?(Hash)

  notepad = ''
  notepads.each do |key, value|
    cache_write(api, ['notepad', key.to_i], value)
    notepad = value if key.to_i == id
  end

  return notepad
end

#network? ⇒ Boolean

Check if this is a Network section

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#scouts? ⇒ Boolean

Check if this is a Scouts section

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#set_notepad(api, content) ⇒ Boolean

Set the section’s notepad in OSM

Parameters:

  • api (Osm::Api) —

    The api to use to make the request

  • content (String) —

    The content of the notepad

Returns:

  • (Boolean) —

    whether the notepad was sucessfully updated



303
304
305
306
307
308
309
310
311
312
 
# File 'lib/osm/section.rb', line 303

def set_notepad(api, content)
  require_access_to_section(api, self)
  data = api.perform_query("users.php?action=updateNotepad&sectionid=#{id}", {'value' => content})

  if data.is_a?(Hash) && data['ok'] # Success
    cache_write(api, ['notepad', id], content)
    return true
  end
  return false
end

#subscription_level_name ⇒ String?

Get the name for the section’s subscription level

Returns:

  • (String, nil) —

    the name of the subscription level (nil if no name exists)



351
352
353
354
355
356
357
 
# File 'lib/osm/section.rb', line 351

def subscription_level_name
  return {
    1 => 'Bronze',
    2 => 'Silver',
    3 => 'Gold',
  }[subscription_level]
end

#waiting? ⇒ Boolean

Check if this is a waiting list

Returns:

  • (Boolean) 


343
344
345
346
347
 
# File 'lib/osm/section.rb', line 343

[:beavers, :cubs, :scouts, :explorers, :network, :adults, :waiting].each do |attribute|
  define_method "#{attribute}?" do
    type == attribute
  end
end

#youth_section? ⇒ Boolean

Check if this section is one of the youth sections

Returns:

  • (Boolean) 


317
318
319
 
# File 'lib/osm/section.rb', line 317

def youth_section?
  [:beavers, :cubs, :scouts, :explorers].include?(type)
end