PageAction Klassenreferenz

Klassendiagramm für PageAction:

Aufstellung aller Elemente

Öffentliche Methoden
	PageAction ()
	saveform ()
	elsave ()
	saveprop ()
	changetemplateselectelements ()
	replacetemplate ()
	el ()
	form ()
	show ()
	edit ()
	src ()
	prop ()
	changetemplate ()
	pub ()
	pubnow ()
	setWindowMenu ($type)
Öffentliche Attribute
	$page
	$defaultSubAction = 'show'

---

Ausführliche Beschreibung

Definiert in Zeile 30 der Datei PageAction.class.php.

---

Dokumentation der Elementfunktionen

PageAction::changetemplate

(

)

Die Eigenschaften der Seite anzeigen

Definiert in Zeile 672 der Datei PageAction.class.php.

Benutzt Template::getAll(), Action::setTemplateVar(), Action::setTemplateVars(), Html::url() und Action::userIsAdmin().

     {
          $this->page->public = true;
          $this->page->load();

          $this->setTemplateVars( $this->page->getProperties() );
          
          if   ( $this->userIsAdmin() )
          {
               $this->setTemplateVar('template_url',Html::url('main','template',$this->page->templateid));
          }
     
          $template = new Template( $this->page->templateid );
          $template->load();
          $this->setTemplateVar('template_name',$template->name);
     
          $templates = Array();
          foreach( Template::getAll() as $id=>$name )
          {
               if   ( $id != $this->page->templateid )
                    $templates[$id]=$name;
          }
          $this->setTemplateVar('templates',$templates); 
     }

PageAction::changetemplateselectelements

(

)

Austauschen der Vorlage vorbereiten

Es wird ein Formualr erzeugt, in dem der Benutzer auswaehlen kann, welche Elemente in welches Element uebernommen werden sollen

Definiert in Zeile 330 der Datei PageAction.class.php.

Benutzt Action::callSubAction(), Action::getRequestVar(), lang() und Action::setTemplateVar().

     {
          $newTemplateId = intval($this->getRequestVar('templateid'));

          if   ( $newTemplateId != 0  )
          {
               $this->setTemplateVar('newTemplateId',$newTemplateId );

               $oldElements = array();
               $oldTemplate = new Template( $this->page->templateid );
               $newTemplate = new Template( $newTemplateId );
               
               foreach( $oldTemplate->getElementIds() as $elementid )
               {
                    $e = new Element( $elementid );
                    $e->load();
                    
                    if   ( !$e->isWritable() )
                         continue;

                    $oldElement = array();
                    $oldElement['name'] = $e->name.' - '.lang('EL_'.$e->type );
                    $oldElement['id'  ] = $e->elementid;

                    $newElements = Array();
                    $newElements[0] = lang('ELEMENT_DELETE_VALUES');
     
                    foreach( $newTemplate->getElementIds() as $newelementid )
                    {
                         $ne = new Element( $newelementid );
                         $ne->load();
                         
                         // Nur neue Elemente anbieten, deren Typ identisch ist
                         if   ( $ne->type == $e->type )
                              $newElements[$newelementid] = lang('ELEMENT').': '.$ne->name.' - '.lang('EL_'.$e->type );
                    }
                    $oldElement['newElementsName'] = 'from'.$e->elementid;
                    $oldElement['newElementsList'] = $newElements;
                    $oldElements[$elementid] = $oldElement;
               }
               $this->setTemplateVar('elements',$oldElements );
          }
          else
          {
               $this->callSubAction('prop');
          }
     }

PageAction::edit

(

)

Die Seite im Bearbeitungsmodus anzeigen

Bei editierbaren Feldern wird ein Editor-Ikon vorangestellt.

Definiert in Zeile 568 der Datei PageAction.class.php.

Benutzt Action::getCharset() und Session::getProjectLanguage().

     {
          // Editier-Icons anzeigen
          $this->page->icons = true;
     
          $this->page->load();
          $this->page->generate();
          $this->page->write();
          
          header('Content-Type: '.$this->page->mimeType().'; charset='.$this->getCharset() );
          
          // HTTP-Header mit Sprachinformation setzen.
          $language = Session::getProjectLanguage();
          header('Content-Language: '.$language->isoCode);

          
          require( $this->page->tmpfile() );

          // Inhalt ist ausgegeben... Skript beenden.
          exit;
     }

PageAction::el

(

)

Alle Elemente der Seite anzeigen

Definiert in Zeile 409 der Datei PageAction.class.php.

Benutzt Text::maxLaenge(), Action::setTemplateVar() und Html::url().

     {
          $this->page->public = true;
          $this->page->simple = true;
          $this->page->generate_elements();
          
          $list = array();
     
          // Schleife ueber alle Inhalte der Seite
          foreach( $this->page->values as $id=>$value )
          {
               // Element wird nur angezeigt, wenn es editierbar ist
               if   ( $value->element->isWritable() )
               {
                    $list[$id] = array();
                    $list[$id]['name']       = $value->element->name;
                    $list[$id]['url' ]       = Html::url( 'pageelement','edit'   ,$this->page->id,array('elementid'=>$id,'mode'=>'edit') );
                    $list[$id]['desc']       = $value->element->desc;
                    $list[$id]['type']       = $value->element->type;
     
                    $list[$id]['archive_count'] = intval($value->getCountVersions());
                    if   ( $list[$id]['archive_count'] > 0 )
                         $list[$id]['archive_url'] = Html::url( 'pageelement','archive',$this->page->id,array('elementid'=>$id) );
                    
                    // Maximal 50 Stellen des Inhaltes anzeigen
                    $list[$id]['value'] = Text::maxLaenge( 50,$value->value );
               }
          }

          $this->setTemplateVar('el',$list);
     }

PageAction::elsave

(

)

Element speichern

Der Inhalt eines Elementes wird abgespeichert

Definiert in Zeile 147 der Datei PageAction.class.php.

Benutzt Action::callSubAction(), Action::forward(), Object::getAllObjectIds(), Session::getElement(), Page::getPageIdFromObjectId(), Session::getProject(), Session::getProjectLanguage(), Action::getRequestVar(), Action::hasRequestVar(), lang() und Action::setTemplateVar().

     {
          $value = new Value();
          $language = Session::getProjectLanguage();
          $value->languageid = $language->languageid;
          $value->objectid   = $this->page->objectid;
          $value->pageid     = Page::getPageIdFromObjectId( $this->page->objectid );

          if   ( $this->hasRequestVar('elementid') )
               $value->element = new Element( $this->getRequestVar('elementid') );
          else
               $value->element = Session::getElement();

          $value->element->load();
          $value->publish = false;
          $value->load();

          $value->number         = $this->getRequestVar('number') * pow(10,$value->element->decimals);
          $value->linkToObjectId = intval($this->getRequestVar('linkobjectid'));
          $value->text           = $this->getRequestVar('text');

          // Vorschau anzeigen
          if   ( $value->element->type=='longtext' && ($this->hasRequestVar('preview')||$this->hasRequestVar('addmarkup')) )
          {
               if   ( $this->hasRequestVar('preview') )
               {
                    $value->page             = $this->page;
                    $value->simple           = false;
                    $value->page->languageid = $value->languageid;
                    $value->page->load();
                    $value->generate();
                    $this->setTemplateVar('preview_text',$value->value );
               }

               if   ( $this->hasRequestVar('addmarkup') )
               {
                    $addText = $this->getRequestVar('addtext');

                    if   ( !empty($addText) ) // Nur, wenn ein Text eingegeben wurde
                    {
                         $addText = $this->getRequestVar('addtext');

                         if   ( $this->hasRequestVar('strong') )
                              $value->text .= '*'.$addText.'*';

                         if   ( $this->hasRequestVar('emphatic') )
                              $value->text .= '_'.$addText.'_';

                         if   ( $this->hasRequestVar('link') )
                              $value->text .= '"'.$addText.'"->"'.$this->getRequestVar('objectid').'"';
                    }

                    if   ( $this->hasRequestVar('table') )
                         $value->text .= "|$addText  |  |\n|$addText  |  |\n|$addText  |  |\n";

                    if   ( $this->hasRequestVar('list') )
                         $value->text .= "\n- ".$addText."\n".'- '.$addText."\n".'- '.$addText."\n";

                    if   ( $this->hasRequestVar('numlist') )
                         $value->text .= "\n# ".$addText."\n".'# '.$addText."\n".'# '.$addText."\n";

                    if   ( $this->hasRequestVar('image') )
                         $value->text .= '{'.$this->getRequestVar('objectid').'}';
               }

               // Ermitteln aller verlinkbaren Objekte (fuer Editor)
               $objects = array();
     
               foreach( Folder::getAllObjectIds() as $id )
               {
                    $o = new Object( $id );
                    $o->load();
                    
                    if   ( $o->getType() != 'folder' )
                    { 
                         $f = new Folder( $o->parentid );
                         $objects[ $id ]  = lang( 'GLOBAL_'.$o->getType() ).': '; 
                         $objects[ $id ] .=  implode( FILE_SEP,$f->parentObjectNames(false,true) ); 
                         $objects[ $id ] .= FILE_SEP.$o->name;
                    } 
               }
               asort($objects);
               $this->setTemplateVar( 'objects' ,$objects );
     
               $this->setTemplateVar( 'release' ,$this->page->hasRight(ACL_RELEASE) );
               $this->setTemplateVar( 'publish' ,$this->page->hasRight(ACL_PUBLISH) );
               $this->setTemplateVar( 'html'    ,$value->element->html );
               $this->setTemplateVar( 'wiki'    ,$value->element->wiki );
               $this->setTemplateVar( 'text'    ,$value->text          );
               $this->setTemplateVar( 'name'    ,$value->element->name );
               $this->setTemplateVar( 'desc'    ,$value->element->desc );
               $this->setTemplateVar( 'objectid',$this->page->objectid );
               $this->forward( 'pageelement_edit_longtext' );
          }

          if   ( $this->hasRequestVar('year') ) // Wird ein Datum gespeichert?
          {
               // Wenn ein ANSI-Datum eingegeben wurde, dann dieses verwenden
               if   ( $this->getRequestVar('ansidate') != $this->getRequestVar('ansidate_orig') )
                    $value->date = strtotime($this->getRequestVar('ansidate') );
               else
                    // Sonst die Zeitwerte einzeln zu einem Datum zusammensetzen
                    $value->date = mktime( $this->getRequestVar('hour'  ),
                                           $this->getRequestVar('minute'),
                                            $this->getRequestVar('second'),
                                            $this->getRequestVar('month' ),
                                            $this->getRequestVar('day'   ),
                                            $this->getRequestVar('year'  ) );
          }
          else $value->date = 0; // Datum nicht gesetzt.
     
          $value->text = $this->getRequestVar('text');

          $value->page = new Page( $value->objectid );
          $value->page->load();
          
          // Inhalt sofort freigegeben, wenn
          // - Recht vorhanden
          // - Freigabe gewuenscht
          if   ( $value->page->hasRight( ACL_RELEASE ) && $this->getRequestVar('release')!='' )
               $value->publish = true;
          else
               $value->publish = false;

          // Inhalt speichern
          
          // Wenn Inhalt in allen Sprachen gleich ist, dann wird der Inhalt
          // fuer jede Sprache einzeln gespeichert.
          if   ( $value->element->allLanguages )
          {
               $project = Session::getProject();
               foreach( $project->getLanguageIds() as $languageid )
               {
                    $value->languageid = $languageid;
                    $value->save();
               }
          }
          else
          {
               // sonst nur 1x speichern (fuer die aktuelle Sprache)
               $value->save();
          }

          $this->page->setTimestamp(); // "Letzte Aenderung" setzen

          // Falls ausgewaehlt die Seite sofort veroeffentlichen
          if   ( $this->hasRequestVar('publish') )
               $this->callSubAction( 'pubnow' ); // Weiter zum veroeffentlichen
          else
               $this->callSubAction( 'el' ); // Element-Liste anzeigen
     }

PageAction::form

(

)

Alle editierbaren Felder in einem Formular bereitstellen

Definiert in Zeile 445 der Datei PageAction.class.php.

Benutzt Action::forward(), Folder::getAllFolders(), Object::getAllObjectIds(), lang(), Action::setTemplateVar() und setWindowMenu().

     {
          global $conf_php;

          $this->page->public = false;
          $this->page->simple = true;
          $this->page->generate_elements();
          
          $list = array();
     
          foreach( $this->page->values as $id=>$value )
          {
               if   ( $value->element->isWritable() )
               {
                    $list[$id] = array();
                    $list[$id]['name']        = $value->element->name;
                    $list[$id]['desc']        = $value->element->desc;
                    $list[$id]['type']        = $value->element->type;
                    $list[$id]['id'  ]        = 'id'.$value->element->elementid;
                    $list[$id]['saveid']      = 'saveid'.$value->element->elementid;

                    switch( $value->element->type )
                    {
                         case 'text':
                         case 'longtext':
                              $list[$id]['value'] = $value->text;
                              break;

                         case 'date':
                              $list[$id]['value'] = date( 'Y-m-d H:i:s',$value->date );
                              break;

                         case 'number':
                              $list[$id]['value'] = $value->number / pow(10,$value->element->decimals);
                              break;

                         case 'select':
                              $list[$id]['list' ] = $value->element->getSelectItems();
                              $list[$id]['value'] = $value->text;
                              break;

                         case 'link':
                              $objects = array();
                    
                              foreach( Folder::getAllObjectIds() as $oid )
                              {
                                   $o = new Object( $oid );
                                   $o->load();
                                   
                                   if   ( $o->getType() != 'folder' )
                                   { 
                                        $f = new Folder( $o->parentid );
                                        $f->load();
                                        
                                        $objects[ $oid ]  = lang( $o->getType() ).': '; 
                                        $objects[ $oid ] .=  implode( ' » ',$f->parentObjectNames(false,true) ); 
                                        $objects[ $oid ] .= ' » '.$o->name;
                                   } 
                              }
          
                              asort( $objects ); // Sortieren
                    
                              $list[$id]['list' ] = $objects;
                              $list[$id]['value'] = $value->linkToObjectId;
                              break;

                         case 'list':
                              $objects = array();
                              foreach( Folder::getAllFolders() as $oid )
                              {
                                   $f = new Folder( $oid );
                                   $f->load();
                                   
                                   $objects[ $oid ]  = lang( $f->getType() ).': '; 
                                   $objects[ $oid ] .=  implode( ' » ',$f->parentObjectNames(false,true) ); 
                              }
                    
                              asort( $objects ); // Sortieren
                    
                              $this->setTemplateVar('list' ,$objects);
                              $this->setTemplateVar('value',$this->value->linkToObjectId);
          
                              break;
                    }
               }
          }

          $this->setTemplateVar( 'release',$this->page->hasRight(ACL_RELEASE) );
          $this->setTemplateVar( 'publish',$this->page->hasRight(ACL_PUBLISH) );

          $this->setWindowMenu( 'elements' );
          $this->setTemplateVar('el',$list);
          $this->forward('page_form');
     }

PageAction::PageAction

(

)

Definiert in Zeile 36 der Datei PageAction.class.php.

Benutzt Session::getObject(), Action::getRequestId() und Session::setObject().

     {
          if   ( $this->getRequestId() != 0  )
          {
               $this->page = new Page( $this->getRequestId() );
               $this->page->load();
               Session::setObject( $this->page );
          }
          else
          {
               $this->page = Session::getObject();
          }
          
          // Auskommentiert, da Conditional-Get bei
          // Seiten u.U. nicht sinnvoll ist
          //$this->lastModified( $this->page->lastchangeDate );
     }

PageAction::prop

(

)

Die Eigenschaften der Seite anzeigen

Definiert in Zeile 618 der Datei PageAction.class.php.

Benutzt Action::forward(), Template::getAll(), Action::setTemplateVar(), Action::setTemplateVars(), Html::url() und Action::userIsAdmin().

     {
          $this->setTemplateVar('id',$this->page->objectid);
     
          $this->page->public = true;
          $this->page->load();
          $this->page->full_filename();

          if   ( $this->page->filename == $this->page->objectid )
               $this->page->filename = '';

          $this->setTemplateVars( $this->page->getProperties() );
          
          if   ( $this->userIsAdmin() )
          {
               $this->setTemplateVar('template_url',Html::url('main','template',$this->page->templateid));
          }
     
          $template = new Template( $this->page->templateid );
          $template->load();
          $this->setTemplateVar('template_name',$template->name);
     
          // Alle Ordner ermitteln
//        $this->setTemplateVar('act_folderobjectid',$this->page->parentid);
//
//        $folders = array();
//        $folder = new Folder( $this->page->parentid );
          
//        foreach( $folder->getOtherFolders() as $oid )
//        {
//             $f = new Folder( $oid );
//             $folders[$oid] = implode( FILE_SEP,$f->parentObjectNames(true,true) );
//        }
//        asort( $folders );
//        $this->setTemplateVar('folder',$folders); 

          $templates = Array();
          foreach( Template::getAll() as $id=>$name )
          {
               if   ( $id != $this->page->templateid )
                    $templates[$id]=$name;
          }
          $this->setTemplateVar('templates',$templates); 
           
     
          $this->forward('page_prop');
     }

PageAction::pub

(

)

Seite veroeffentlichen

Es wird ein Formular angzeigt, mit dem die Seite veroeffentlicht werden kann

Definiert in Zeile 707 der Datei PageAction.class.php.

     {
     }

PageAction::pubnow

(

)

Seite veroeffentlichen

Die Seite wird generiert.

Definiert in Zeile 718 der Datei PageAction.class.php.

Benutzt Action::addNotice().

     {
          if   ( !$this->page->hasRight( ACL_PUBLISH ) )
               die( 'no right for publish' );

          $this->page->public = true;
          $this->page->publish();
          $this->page->publish->close();

//        foreach( $this->page->publish->publishedObjects as $o )
//        {
//             $this->addNotice($o['type'],$o['full_filename'],'PUBLISHED','ok');
//        }

          $this->addNotice('page',$this->page->fullFilename,'PUBLISHED'.($this->page->publish->ok?'':'_ERROR'),$this->page->publish->ok,array(),$this->page->publish->log);

          $this->callSubaction('pub');
     }

PageAction::replacetemplate

(

)

Die Vorlage der Seite austauschen

Die Vorlage wird ausgetauscht, die Inhalte werden gemaess der Benutzereingaben kopiert

Definiert in Zeile 385 der Datei PageAction.class.php.

Benutzt Action::addNotice() und Action::getRequestVar().

     {
          $newTemplateId = intval($this->getRequestVar('newTemplateId'));
          $replaceElementMap = Array();
          
          $oldTemplate = new Template( $this->page->templateid );
          foreach( $oldTemplate->getElementIds() as $elementid )
               $replaceElementMap[$elementid] = $this->getRequestVar('from'.$elementid);
          
          if   ( $newTemplateId != 0  )
          {
               $this->page->replaceTemplate( $newTemplateId,$replaceElementMap );
               $this->addNotice('page',$this->page->name,'SAVED',OR_NOTICE_OK);
          }
          else
               $this->addNotice('page',$this->page->name,'NOT_SAVED',OR_NOTICE_WARN);
     }

PageAction::saveform

(

)

Alle Daten aus dem Formular speichern

Definiert in Zeile 58 der Datei PageAction.class.php.

Benutzt Action::callSubAction(), Page::getPageIdFromObjectId(), Action::getRequestVar(), Action::getSessionVar() und Action::hasRequestVar().

     {
          $this->page->public = true;
          $this->page->simple = true;

          foreach( $this->page->getElements() as $elementid=>$name )
          {
               if   ( $this->hasRequestVar('saveid'.$elementid) )
               {
                    $value = new Value();
                    $value->objectid   = $this->page->objectid;
                    $value->pageid     = Page::getPageIdFromObjectId( $value->objectid );
                    $value->element = new Element( $elementid );
                    $value->element->load();
                    $value->publish = false;
                    $value->load();
          
                    // Eingegebenen Inhalt aus dem Request lesen
                    $inhalt  = $this->getRequestVar( 'id'.$elementid );
                    
                    // Den Inhalt speichern.
                    switch( $value->element->type )
                    {
                         case 'number':
                              $value->number = $inhalt * pow(10,$value->element->decimals);
                              break;

                         case 'date':
                              $value->date = strtotime( $inhalt );
                              break;

                         case 'text':
                         case 'longtext':
                         case 'select':
                              $value->text = $inhalt;
                              break;

                         case 'link':
                         case 'list':
                         case 'insert':
                              $value->linkToObjectId = intval($inhalt);
                              break;
                    }
               
                    $value->page = &$this->page;
                    
                    // Ermitteln, ob Inhalt sofort freigegeben werden kann und soll
                    if   ( $this->page->hasRight( ACL_RELEASE ) && $this->hasRequestVar('release') )
                         $value->publish = true;
                    else
                         $value->publish = false;
          
//                  Html::debug($inhalt,'Eingabe');
//                  Html::debug($value,'Inhalt');
          
                    // Inhalt speichern.
                    // Inhalt in allen Sprachen gleich?
                    if   ( $value->element->allLanguages )
                    {
                         // Inhalt fuer jede Sprache einzeln speichern.
                         $p = new Project();
                         foreach( $p->getLanguageIds() as $languageid )
                         {
                              $value->languageid = $languageid;
                              $value->save();
                         }
                    }
                    else
                    {
                         // sonst nur 1x speichern (fuer die aktuelle Sprache)
                         $value->languageid = $this->getSessionVar(REQ_PARAM_LANGUAGE_ID);
                         $value->save();
                    }
               }
          }
          $this->page->setTimestamp(); // "Letzte Aenderung" setzen

          if   ( $this->hasRequestVar('publish') )
               $this->callSubAction( 'pubnow' );
          else
               $this->callSubAction( 'el' );
     }

PageAction::saveprop

(

)

Eigenschaften der Seite speichern

Definiert in Zeile 304 der Datei PageAction.class.php.

Benutzt Action::addNotice(), Action::addValidationError(), Action::callSubAction() und Action::getRequestVar().

     {
          if   ( $this->getRequestVar('name')!='' )
          {
               $this->page->name        = $this->getRequestVar('name'       );
               $this->page->filename    = $this->getRequestVar('filename'   );
               $this->page->desc        = $this->getRequestVar('description');

               $this->page->save();
               $this->addNotice($this->page->getType(),$this->page->name,'PROP_SAVED','ok');
          }
          else
          {
               $this->addValidationError('name');
               $this->callSubAction('prop');
          }
     }

PageAction::setWindowMenu

(

$

type

)

Definiert in Zeile 738 der Datei PageAction.class.php.

Benutzt Action::setTemplateVar().

Wird benutzt von form().

                                     {
          switch( $type)
          {
               case 'elements':
                    $menu = array( array('subaction'=>'el'  ,'text'=>'all'),
                                   array('subaction'=>'form','text'=>'change'    )  );
                    $this->setTemplateVar('windowMenu',$menu);
                    break;
               case 'acl':
                    $menu = array( array('subaction'=>'rights' ,'text'=>'show'),
                                 array('subaction'=>'aclform','text'=>'add' ) );
                    $this->setTemplateVar('windowMenu',$menu);
                    break;

          }
     }

PageAction::show

(

)

Seite anzeigen

Definiert in Zeile 545 der Datei PageAction.class.php.

Benutzt Action::getCharset() und Session::getProjectLanguage().

     {
          // Seite definieren
          $this->page->load();
          $this->page->generate();
          $this->page->write();

          header('Content-Type: '.$this->page->mimeType().'; charset='.$this->getCharset() );

          // HTTP-Header mit Sprachinformation setzen.
          $language = Session::getProjectLanguage();
          header('Content-Language: '.$language->isoCode);

          require( $this->page->tmpfile() );
     }

PageAction::src

(

)

Den Quellcode der Seite anzeigen

Alle HTML-Sonderzeichen werden maskiert

Definiert in Zeile 597 der Datei PageAction.class.php.

Benutzt Action::setTemplateVar().

     {
          $this->page->public = true;
          $this->page->load();
     
          $src = $this->page->generate();
          
          // HTML Highlighting
          
          //$src = preg_replace( '|<(.+)( .+)?'.'>|Us'       , '<strong>&lt;$1</strong>$2<strong>&gt;</strong>', $src);
          //$src = preg_replace( '|([a-zA-Z]+)="(.+)"|Us' , '<em>$1</em>=<var>"$2"</var>'                   , $src);
          $src = htmlentities($src);
          
          $this->setTemplateVar('src',$src);
     }

---

Dokumentation der Datenelemente

PageAction::$defaultSubAction = 'show'

Definiert in Zeile 33 der Datei PageAction.class.php.

PageAction::$page

Definiert in Zeile 32 der Datei PageAction.class.php.

---

Die Dokumentation für diese Klasse wurde erzeugt aufgrund der Datei:

• actionClasses/PageAction.class.php