aus "Stud.IP-Entwicklerdokumentation"

Entwickler: MultiPersonSearch

MultiPersonSearch-Klasse

lib/classes/MultiPersonSearch.class.php stellt eine Klasse bereit, mit der ein Dialog zum Hinzufügen von mehreren Personen erstellt werden kann. Ist JavaScript aktiviert, wird dazu ein Modaler Dialog geöffnet, anderenfalls wird ein Fallback angezeigt.

Einbau im View

Mit dem folgenden Quelltext wird ein MultiPersonSearch Objekt erzeugt und als Link ausgegeben.

  1. $mp = MultiPersonSearch::get('eindeutige_id')
  2.     ->setLinkText(_('Beispiellink'))
  3.     ->setTitle(_('Titel des Dialogs'))
  4.     ->setDefaultSelectedUser($defaultSelectedUser)
  5.     ->setExecuteURL($this->url_for('controller'))
  6.     ->setSearchObject($searchObj)
  7.     ->addQuickfilter(_('Name des Quickfilters'), $userArray)
  8.     ->render();
  9.  
  10. print $mp;

Übersicht wichtiger Methoden

Verarbeitung

Um die über den Dialog ausgewählten Personen zu speichern, muss mittels setExecuteURL($action) eine entsprechende URL (z. B. zu einem Controller) bereitgestellt werden.

Im Controller kann nun mittels load($name) das MultiPersonSearch Objekt geladen werden. Die Funktion getAddedUsers() liefert ein Array mit allen neu ausgewählten User-Ids zurück.

  1. $mp = MultiPersonSearch::load('eindeutige_id');
  2.  
  3. foreach ($mp->getAddedUsers() as $userId) {
  4.     do_something($userId);
  5. }
URL: https://docs.studip.de/develop/Entwickler/MultiPersonSearch
Zuletzt geändert am 18.06.2014 15:19 Uhr