Skip to content

Offer related statuses in Volontulo

Filip Górczyński edited this page Oct 29, 2015 · 2 revisions

This page describes offer-related statuses regarding:

  • Offer — as an object in the system
  • Recruitment — as a state of the recruitment of Volunteers for an Action
  • Action — as the real activity of Volunteers

Possible statuses

Possible offer-related statuses are:

  • Offer:

  • unpublished

  • published

  • rejected

  • Recruitment:

  • open

  • supplemental

  • closed

  • Action:

  • future

  • ongoing

  • finished

Notes:

  • Offer status depends on Organization and Administrator actions.
  • Recruitment status depends on date boundaries, required volunteers limits and current state (at viewing moment).
  • Action status depends on date boundaries and current state (at viewing moment).
  • Whenever date is mentioned, it actually means date and time.
  • Whenever Organization is used, it means a User who represents an Organization.

Offer statuses

An Offer can be:

  • unpublished:
    • after adding by Organization and before moderation by Administrator,
  • after editing by Organization and before moderation by Administrator,
  • published:
  • after positive moderation by Administrator,
  • rejected:
  • after negative moderation by Administrator.

Recruitment statuses

Within an Offer, Recruitment at a specific moment can be:

  • open,
  • supplemental,
  • closed.

Note:

  • Supplemental recruitment is optional, up to Organization preference set during the Offer creation.

The Recruitment status depends on several conditions, namely:

  • date boundaries:
  • as recruitment always starts with the offer creation, the start date of Recruitment always equals the Offer creation date,
  • Organization can define a moment in time, after which the Recruitment status turns to Closed,
  • Organization can define a moment in time, after which the Recruitment status turns to Supplemental (this moment needs to be earlier than the moment at which the Recruitment turns to Closed)
  • reaching required Volunteers number:
  • Organization can define the number of Volunteers required, after which the Recruitment status turns to Closed or Supplemental. Date boundaries are used accordingly.
  • manual change — whenever Organization decides the recruitment should not be continued, they can change it to “Closed” or “Open” manually. Manually set “Closed” status overrides other boundaries, but for Open status, date and number boundaries are used.

Action statuses

The following dates can be set for an Action:

  • start date,
  • end date.

Both start and end dates are not obligatory, so based on this, an Action can be:

  • constant (neither start nor end date specified),
  • starting at some point in time, and from then constant (start date specified, no end date specified),
  • time limited (both start and end dates specified).

As such, at specific moment Action can be:

  • ongoing,
  • future (applies only to actions with start dates),
  • closed (applies only to Actions with end dates).

Dependencies between Action and Recruitment dates

The following dependencies apply:

  • If an Action has end date defined, Recruitment cannot be Open or Supplemental after this date.
  • If an Action has start date defined, Recruitment needs to start before this date.

Filter examples

The following filters can be built for example based upon the defined statuses.

  • Offers invisible for visitors (anyone without administrative rights):

  • Offer: unpublished, Recruitment: any, Action: any

  • Offer: rejected, Recruitment: any, Action: any

  • Offers currently accepting recruitment:

  • Offer: published, Recruitment: open, Action: future

  • Offer: published, Recruitment: open, Action: ongoing

  • Offer: published, Recruitment: supplementary, Action: future

  • Offer: published, Recruitment: supplementary, Action: ongoing

  • Offers visible in system, but without running recruitment:

  • Offer: published, Recruitment: closed, Action: any

  • Finished actions (applicable for success stories):

  • Offer: published, Recruitment: closed, Action: closed