init_events

Tag {init_events} prints out event objects in the current section. It is often used in combination with calendar object.

 

Parameters

  • parent - ID number of the current section where events belong. If parent is undefined then  current page ID is used.
  • name - variable name where the returned data is saved. Default value is "eventlist".
  • position - defines the location of sections' list on the page.
  • order - defines the ordering of events loop. Could be either ascending (value then "asc") or descending (value "desc"). Possible values to order by are: title, date, start_time, end_time. Default ordering is by start_time, then title.
  • start - the starting row number to return. 3.x
  • limit - the number of rows to return. You must use this parameter always with "start" parameter. 3.x
  • start_time - return events between start_time and end_time, in format dd.mm.yyyy. 4.0.0
  • end_time - return events between start_time and end_time, in format dd.mm.yyyy. 4.0.0
  • metadata - defines the type of metadata set events use in this section. Only used then metadata sets exist in a database.
    This functionality is deprecated in version 4, please use profiles instead.
  • on_create - allows to publish all objects immediately. If the parameter has value "on_create=publish", then a created object is published immediately. Default value is "hide". 4.0.2
  • where - additional filtering criteria using WHERE SQL syntax. 4
  • buttons - defines which action buttons are displayed to the site editor. Values can be "new,edit,hide,move,delete". 4.0.14
  • user - list of users to display. 4

Attributes

  • id - ID number of the current event.
  • href - link to the current event.
  • title - title of the current event.
  • is_selected - value is 1 in case of active (selected or current) event, 0 otherwise.
  • buttons - action-buttons for the current event.
  • start_date - start date of the event in format dd.mm.yyyy
  • start_time - start time of the event in format hh:mm.
    Since version 3.3.0 new format is dd.mm.yyyy hh:mm
  • start_date_long - start date of the event in format dd. month yyyy
  • end_date - end date of the event in format dd.mm.yyyy
  • end_time - end time of the event in format hh:mm
    Since version 3.3.0 new format is dd.mm.yyyy hh:mm
  • end_date_long - end date of the event in format dd. month yyyy
  • description - description of the event
  • created_user_id - user ID who initially created the object. 4.0.3
  • created_user_name - user full name who initially created the object. 4.0.3
  • changed_user_id - user ID who made the last object saving. 4.0.3
  • changed_user_name - user full name who made the last object saving. 4.0.3
  • created_time - creating time of the object in format dd.mm.yyyy hh:ii. 4.0.3
  • fcreated_time - creating time of the object in database default format, eg yyyy-mm-dd hh:ii. 4.0.3
  • changed_time - last saving time of the object in format dd.mm.yyyy hh:ii. 4.0.3
  • fchanged_time - last saving time of the object in database default format, eg yyyy-mm-dd hh:ii. 4.0.3

General tags

  • <name>_newbutton - prints "New" action-button for creating a new object.
  • <name>_count - the number of returned objects. If parameter "limit" is set then count equals to "limit" value.
  • <name>_counttotal - the total number of objects found, not affected by "limit" parameter.  3.3.7