Changeset 25507 for trunk/include/calendar_base.class.php

Timestamp:

Nov 17, 2013, 4:03:32 PM (10 years ago)

Author:

mistic100

Message:

feature 2999 : documentation of include/functions_calendar.inc.php and Calendar classes

File:

• trunk/include/calendar_base.class.php (modified) (8 diffs)

trunk/include/calendar_base.class.php

@@ -23 +23 @@
 
 /**
+ * @package functions\calendar
+ */
+
+
+/**
  * Base class for monthly and weekly calendar styles
  */
-class CalendarBase
+abstract class CalendarBase
 {
-  // db column on which this calendar works
+  /** db column on which this calendar works */
   var $date_field;
-  // used for queries (INNER JOIN or normal)
+  /** used for queries (INNER JOIN or normal) */
   var $inner_sql;
-  //
+  /** used to store db fields */
   var $calendar_levels;
 
   /**
-   * Initialize the calendar
-   * @param string inner_sql used for queries (INNER JOIN or normal)
+   * Generate navigation bars for category page.
+   *
+   * @return boolean false indicates that thumbnails where not included
+   */
+  abstract function generate_category_content();
+
+  /**
+   * Returns a sql WHERE subquery for the date field.
+   *
+   * @param int $max_levels (e.g. 2=only year and month)
+   * @return string
+   */
+  abstract function get_date_where($max_levels);
+
+  /**
+   * Initialize the calendar.
+   *
+   * @param string $inner_sql
    */
   function initialize($inner_sql)
@@ -52 +73 @@
   }
 
+  /**
+   * Returns the calendar title (with HTML).
+   *
+   * @return string
+   */
   function get_display_name()
   {
@@ -83 +109 @@
   }
 
-//--------------------------------------------------------- private members ---
-  /**
-   * Returns a display name for a date component optionally using labels
-  */
-  function get_date_component_label($level, $date_component)
+  /**
+   * Returns a display name for a date component optionally using labels.
+   *
+   * @return string
+   */
+  protected function get_date_component_label($level, $date_component)
   {
     $label = $date_component;
@@ -102 +129 @@
 
   /**
-   * Gets a nice display name for a date to be shown in previos/next links.
-   */
-  function get_date_nice_name($date)
+   * Gets a nice display name for a date to be shown in previous/next links
+   *
+   * @param string $date
+   * @return string
+   */
+  protected function get_date_nice_name($date)
   {
     $date_components = explode('-', $date);
@@ -126 +156 @@
    * Creates a calendar navigation bar.
    *
-   * @param array date_components
-   * @param array items - hash of items to put in the bar (e.g. 2005,2006)
-   * @param bool show_any - adds any link to the end of the bar
-   * @param bool show_empty - shows all labels even those without items
-   * @param array labels - optional labels for items (e.g. Jan,Feb,...)
-   * @return string the navigation bar
-   */
-  function get_nav_bar_from_items($date_components, $items,
+   * @param array $date_components
+   * @param array $items - hash of items to put in the bar (e.g. 2005,2006)
+   * @param bool $show_any - adds any link to the end of the bar
+   * @param bool $show_empty - shows all labels even those without items
+   * @param array $labels - optional labels for items (e.g. Jan,Feb,...)
+   * @return string
+   */
+  protected function get_nav_bar_from_items($date_components, $items,
                                   $show_any,
                                   $show_empty=false, $labels=null)
@@ -204 +234 @@
    * Creates a calendar navigation bar for a given level.
    *
-   * @param int level - the level (0-year,1-month/week,2-day)
-   * @return void
-   */
-  function build_nav_bar($level, $labels=null)
+   * @param int $level - 0-year, 1-month/week, 2-day
+   */
+  protected function build_nav_bar($level, $labels=null)
   {
     global $template, $conf, $page;
@@ -262 +291 @@
    * the currently choosen date.
    */
-  function build_next_prev()
+  protected function build_next_prev()
   {
     global $template, $page;
@@ -344 +373 @@
   }
 }
+
 ?>