Stud.IP  5.4
Modul Class Reference
Inheritance diagram for Modul:
ModuleManagementModelTreeItem ModuleManagementModel MvvTreeItem SimpleORMap ModuleManagementInterface

Public Member Functions

 __construct ($id=null)
 
 getTrailParentId ()
 
 getTrailParent ()
 
 getChildren ()
 
 hasChildren ()
 
 getParents ($mode=null)
 
 getDisplayName ()
 
 getDisplaySemesterValidity ()
 
 getDefaultLanguage ()
 
 getDeskriptor ($language=null, $force_new=false)
 
 assignResponsibleInstitute ($institut_id)
 
 assignInstitutes ($institut_ids)
 
 assignLanguagesOfInstruction ($languages)
 
 getResponsibleInstitutes ()
 
 copy ($deep=true, $with_assignments=false)
 
 getVariants ()
 
 validate ()
 
 getAssignedCoursesBySemester ($semester_id, $only_visible=true)
 
- Public Member Functions inherited from ModuleManagementModelTreeItem
 getTrailParentId ()
 
 getTrails ($types=null, $mode=null, $path=null, $in_recursion=false)
 
 isAssignable ()
 
 hasChildren ()
 
- Public Member Functions inherited from ModuleManagementModel
 verifyPermission ($user_id=null)
 
 store ()
 
 validate ()
 
 delete ()
 
 setNewId ()
 
 getDisplayName ()
 
 getAvailableTranslations ()
 
 getStatus ()
 
 hasPublicStatus ($filter=null)
 
 getResponsibleInstitutes ()
 
 getVariant ()
 
- Public Member Functions inherited from SimpleORMap
 __construct ($id=null)
 
 __clone ()
 
 getRelationOptions ($relation)
 
 getTableMetadata ()
 
 hasAutoIncrementColumn ()
 
 setId ($id)
 
 getId ()
 
 getNewId ()
 
 toArray ($only_these_fields=null)
 
 toRawArray ($only_these_fields=null)
 
 toArrayRecursive ($only_these_fields=null)
 
 getValue ($field)
 
 getRelationValue ($relation, $field)
 
 getDefaultValue ($field)
 
 setValue ($field, $value)
 
 __get ($field)
 
 __set ($field, $value)
 
 __isset ($field)
 
 offsetExists ($offset)
 
 offsetGet ($offset)
 
 offsetSet ($offset, $value)
 
 offsetUnset ($offset)
 
 getIterator ()
 
 count ()
 
 isField ($field)
 
 isRelation ($field)
 
 isAdditionalField ($field)
 
 isAliasField ($field)
 
 isI18nField ($field)
 
 setData ($data, $reset=false)
 
 isNew ()
 
 isDeleted ()
 
 setNew ($is_new)
 
 getWhereQuery ()
 
 restore ()
 
 store ()
 
 triggerChdate ()
 
 delete ()
 
 isDirty ()
 
 isFieldDirty ($field)
 
 revertValue ($field)
 
 getPristineValue ($field)
 
 initRelation ($relation)
 
 resetRelation ($relation)
 
 cleanup ()
 
- Public Member Functions inherited from MvvTreeItem
 getId ()
 

Static Public Member Functions

static getClassDisplayName ($long=false)
 
static getEnriched ($modul_id)
 
static getAllEnriched ($sortby='chdate', $order='ASC', $row_count=null, $offset=null, $filter=null)
 
static getCount ($filter=null)
 
static findBySearchTerm ($term, $filter=null)
 
static findByStgteilAbschnitt ($abschnitt_id, $filter)
 
static findByInstitut ($sortby='chdate', $order='ASC', $filter=[], $row_count=null, $offset=null)
 
static findByLvgruppe ($lvgruppe_id)
 
static getAssignedInstitutes ($sortby='name', $order='ASC', $modul_ids=[])
 
static getAllAssignedInstitutes ($sortby='name', $order='ASC', $filter=null, $row_count=null, $offset=null)
 
static findStatusByIds ($modul_ids=null)
 
static findByFilter ($filter)
 
static search ($search_term, $only_public=true)
 
static publicModulesAvailable ()
 
- Static Public Member Functions inherited from ModuleManagementModelTreeItem
static getPathes ($trails, $delimiter=' · ')
 
static filterTrails ($trails, $filter_objects)
 
static setObjectFilter ($class_name, $filter_func)
 
- Static Public Member Functions inherited from ModuleManagementModel
static findBySearchTerm ($search_term, $filter=null)
 
static getAll ()
 
static get ($id=null)
 
static getEnriched ($id)
 
static getEnrichedByQuery ($query=null, $params=[], $row_count=null, $offset=null)
 
static getClassDisplayName ($long=false)
 
static getFilterSql ($filter, $where=false, $or_sql=null)
 
static getContentArray (SimpleORMap $sorm, $to_utf8=true)
 
static getCount ($filter=null)
 
static getCountBySql ($sql, $filter=null)
 
static setLanguage ($language)
 
static setContentLanguage ($language)
 
static getLanguage () = htmlReady($modul['name'])
 
static getLocaleOrdinalNumberSuffix ($num)
 
static getPublicStatus ($class_name=null)
 
static findCached ($id, $index=null)
 
static clearCache ($index=null)
 
- Static Public Member Functions inherited from SimpleORMap
static tableScheme ($db_table)
 
static expireTableScheme ()
 
static exists ($id)
 
static countBySql ($sql='1', $params=[])
 
static create ($data)
 
static buildExisting ($data)
 
static import ($data)
 
static findBySQL ($sql, $params=[])
 
static findOneBySQL ($where, $params=[])
 
static findThru ($foreign_key_value, $options)
 
static findEachBySQL ($callable, $sql, $params=[])
 
static findMany ($pks=[], $order='', $order_params=[])
 
static findEachMany ($callable, $pks=[], $order='', $order_params=[])
 
static findAndMapBySQL ($callable, $where, $params=[])
 
static findAndMapMany ($callable, $pks=[], $order='', $order_params=[])
 
static deleteBySQL ($where, $params=[])
 
static toObject ($id_or_object)
 
static __callStatic ($name, $arguments)
 

Static Protected Member Functions

static configure ($config=[])
 
- Static Protected Member Functions inherited from ModuleManagementModelTreeItem
static sortTrails ($trail_a, $trail_b)
 
- Static Protected Member Functions inherited from ModuleManagementModel
static configure ($config=[])
 
static checkSortFields ($sort, $standard_field=null, $additional_fields=[])
 
static createSortStatement ($sort, $order='ASC', $standard_field=null, $additional_fields=[])
 
static fromCache ($index, $id, Callable $finder)
 
static formatDisplayName (string $template, array $placeholders, array $replacements)
 
- Static Protected Member Functions inherited from SimpleORMap
static db_table ()
 
static db_fields ()
 
static pk ()
 
static default_values ()
 
static serialized_fields ()
 
static alias_fields ()
 
static i18n_fields ()
 
static additional_fields ()
 
static has_many ()
 
static has_one ()
 
static belongs_to ()
 
static has_and_belongs_to_many ()
 
static registered_callbacks ()
 
static known_slots ()
 
static notification_map ()
 
static getter_setter_map ()
 
static configure ($config=[])
 
static config ($key)
 
static registerCallback ($types, $cb)
 
static unregisterCallback ($types, $cb)
 

Additional Inherited Members

- Data Fields inherited from ModuleManagementModel
 $object_real_name = ''
 
- Data Fields inherited from SimpleORMap
const ID_SEPARATOR = '_'
 
- Data Fields inherited from MvvTreeItem
const TRAIL_SHOW_INCOMPLETE = 1
 
- Static Public Attributes inherited from ModuleManagementModelTreeItem
static $TRAIL_DEFAULT
 
- Static Public Attributes inherited from SimpleORMap
static $schemes = null
 
- Protected Member Functions inherited from ModuleManagementModel
 logChanges ($action=null)
 
- Protected Member Functions inherited from SimpleORMap
 _getId ($field)
 
 _setId ($field, $value)
 
 _getAdditionalValueFromRelation ($field)
 
 _setAdditionalValueFromRelation ($field, $value)
 
 _getAdditionalValue ($field)
 
 _setAdditionalValue ($field, $value)
 
 parseRelationOptions ($type, $name, $options)
 
 storeRelations ($only_these=null)
 
 deleteRelations ()
 
 initializeContent ()
 
 applyCallbacks ($type)
 
 cbNotificationMapper ($cb_type)
 
 cbAfterInitialize ($cb_type)
 
 setSerializedValue ($field, $value)
 
 setI18nValue ($field, $value)
 
- Protected Attributes inherited from ModuleManagementModel
 $is_dirty = false
 
- Protected Attributes inherited from SimpleORMap
 $content = []
 
 $content_db = []
 
 $is_new = true
 
 $is_deleted = false
 
 $relations = []
 
 $additional_data = []
 
- Static Protected Attributes inherited from ModuleManagementModelTreeItem
static $object_filter = []
 
- Static Protected Attributes inherited from ModuleManagementModel
static $filter_params = []
 
static $perm_object = null
 
static $object_cache = []
 
- Static Protected Attributes inherited from SimpleORMap
static $config = []
 
static $reserved_slots = ['value','newid','iterator','tablemetadata', 'relationvalue','wherequery','relationoptions','data','new','id']
 
static $performs_batch_operation = false
 

Constructor & Destructor Documentation

◆ __construct()

__construct (   $id = null)

Member Function Documentation

◆ assignInstitutes()

assignInstitutes (   $institut_ids)

Assigns other institutes (by id) to this module.

Parameters
array$institut_idsArray of institute ids.

◆ assignLanguagesOfInstruction()

assignLanguagesOfInstruction (   $languages)

Assignes languages of instruction to this part-module.

Parameters
type$languagesAn array of language keys defined in mvv_config.php.

◆ assignResponsibleInstitute()

assignResponsibleInstitute (   $institut_id)

Assigns the responsible institute to this Modul. A Modul has only one (but always one) responsible institute.

Parameters
string$institut_idThe id of the institute to assign.
Returns
boolean True if institute was successfully assigned.

◆ configure()

static configure (   $config = [])
staticprotected

◆ copy()

copy (   $deep = true,
  $with_assignments = false 
)

Returns a "deep" copy of this object.

Parameters
boolean$deepCopy all assigned modulteile if true
Returns
Modul A copy of this module.

◆ findByFilter()

static findByFilter (   $filter)
static

Returns an array with ids of all modules found by the given filter. The fields from tables mvv_modul and mvv_modul_inst are possible filter options. If no filter is set an empty array will be returned.

See also
ModuleManagementModel::getFilterSql()
Parameters
array$filterKey-value pairs of filed names and values to filter the result set.
Returns
array An array of Modul ids.

◆ findByInstitut()

static findByInstitut (   $sortby = 'chdate',
  $order = 'ASC',
  $filter = [],
  $row_count = null,
  $offset = null 
)
static

Primarily to find Module by Institute. Possible filters are all fields of the tables mvv_modul, mvv_modulteil, mvv_modul_inst and mvv_modul_deskriptor.

Possible fileds to sort by are count_modulteile, bezeichnung (the name of the modul dereived from the descriptor in the default language) and all fields of table mvv_modul.

Parameters
string$sortby
string$order
array$filter
int$row_count
int$offset
Returns
array Array of Module.

◆ findByLvgruppe()

static findByLvgruppe (   $lvgruppe_id)
static

Returns all modules the given LV-Gruppe is assigned to at least one Modulteile.

Parameters
string$lvgruppe_idThe id of a LV-Gruppe.
Returns
object A SimpleORMapCollection of modules.

◆ findBySearchTerm()

static findBySearchTerm (   $term,
  $filter = null 
)
static

◆ findByStgteilAbschnitt()

static findByStgteilAbschnitt (   $abschnitt_id,
  $filter 
)
static

Returns all modules assigned to the given Studiengangteil-Abschnitt.

Parameters
string$abschnitt_idThe id of a Studiengangteil-Abschnitt
array$filterKey-value pairs of filed names and values to filter the result set.
Returns
object A SimpleORMapCollection of modules.

◆ findStatusByIds()

static findStatusByIds (   $modul_ids = null)
static

Returns an array with all types of status found by given modul ids as key and the number of associated module as value.

See also
mvv_config.php for defined status.
Parameters
array$modul_ids
Returns
array An array with status key as key and an array of name of status and number of Module with this status.

◆ getAllAssignedInstitutes()

static getAllAssignedInstitutes (   $sortby = 'name',
  $order = 'ASC',
  $filter = null,
  $row_count = null,
  $offset = null 
)
static

Returns all institutes assigned to Module. Sorted and filtered by optional parameters.

Parameters
string$sortbyDB field to sort by.
string$orderASC or DESC
array$filterArray of filter.
Returns
array Array of found Fachbereiche.

◆ getAllEnriched()

static getAllEnriched (   $sortby = 'chdate',
  $order = 'ASC',
  $row_count = null,
  $offset = null,
  $filter = null 
)
static

Returns all or a specified (by row count and offset) number of Module sorted and filtered by given parameters and enriched with some additional fields. This function is mainly used in the list view.

Parameters
string$sortbyField name to order by.
string$orderASC or DESC direction of order.
int$row_countThe max number of objects to return.
int$offsetThe first object to return in a result set.
array$filterKey-value pairs of filed names and values to filter the result set.
Returns
SimpleORMapCollection A collection of module objects.

◆ getAssignedCoursesBySemester()

getAssignedCoursesBySemester (   $semester_id,
  $only_visible = true 
)

Retrieves all courses this Modul is assigned by its parts and assigned LV-Gruppen. Filtered by a given semester considering the global visibility or the the visibility for a given user.

Parameters
string$semester_idThe id of a semester.
mixed$only_visibleBoolean true retrieves only visible courses, false retrieves all courses. If $only_visible is an user id it depends on the users status which courses will be retrieved.
Returns
array An array of course data.

◆ getAssignedInstitutes()

static getAssignedInstitutes (   $sortby = 'name',
  $order = 'ASC',
  $modul_ids = [] 
)
static

Returns all Institutes assigned to the given modules.

Parameters
string$sortbyField to sort by.
string$orderOrder of sorting (ASC or DESC).
array$modul_idsIds of modules.
Returns
object a SimpleORMapColection of institutes.

◆ getChildren()

getChildren ( )

◆ getClassDisplayName()

static getClassDisplayName (   $long = false)
static

◆ getCount()

static getCount (   $filter = null)
static

Returns the number of modules optional filtered by $filter.

Parameters
array$filterKey-value pairs of filed names and values to filter the result set.
Returns
int The number of modules

◆ getDefaultLanguage()

getDefaultLanguage ( )

Returns the default language for the module descriptor.

Returns
string Short name of language (see mvv_config.php)

◆ getDeskriptor()

getDeskriptor (   $language = null,
  $force_new = false 
)

Returns the Deskriptor in the given language. A Modul has always a Deskriptor in the default language. If the given language is unknown, the method returns the deskriptor in the default language.

Parameters
string$languageThe id of the language
boolIf true returns always a new descriptor
Returns
object The Deskriptor.

◆ getDisplayName()

getDisplayName ( )

Returns the name of the object to displa in the trail.

Returns
string

Implements MvvTreeItem.

◆ getDisplaySemesterValidity()

getDisplaySemesterValidity ( )

Returns a string representation of this module's validity by semesters.

Returns
string The string with the validity by semesters.

◆ getEnriched()

static getEnriched (   $modul_id)
static

Retrieves the module and all related data and some additional fields.

Parameters
string$modul_idThe id of the module.
Returns
object The module with additional data or a new module.

◆ getParents()

getParents (   $mode = null)

◆ getResponsibleInstitutes()

getResponsibleInstitutes ( )

◆ getTrailParent()

getTrailParent ( )

◆ getTrailParentId()

getTrailParentId ( )

◆ getVariants()

getVariants ( )

Retrieves all modules this module ia a variant of.

Returns
array An array of all variants.

◆ hasChildren()

hasChildren ( )

◆ publicModulesAvailable()

static publicModulesAvailable ( )
static

Checks if modules with public status are available.

Returns
boolean true if modules with public status available

◆ search()

static search (   $search_term,
  $only_public = true 
)
static

Search modules by search term. This function is used in the search frontend for modules.

Parameters
string$search_term
boolean$only_publicIf true search only for modules with public status.

◆ validate()

validate ( )

The documentation for this class was generated from the following file: