c:/www/apache/doc2//form/assistant.incUlf WendelAssistant/wizard that guides a user through several forms.$Id: assistant.inc,v 1.18 2000/12/19 13:34:14 uw Exp $Restores the Assistant. Load the pages with values, sets validation flags etc.form_errorSets the path to the templatesform_errorCreates a new template object.$template_filesSet the template filesshow()Returns the current page.show()Prints and returns the HTML code of the assistant.getGet the values of the last form.Load the form with values before we display it.isValid()currentPageID()Return the name of the current pageisValid()currentPageName()The first page defined with addPage() call gets the ID 0, the second 1 and so on.If a negative number is returned the help or exit button is pressed.Returns the ID of the current page.isValid() -1: not foundform_errorReturns the page_id (page__values/page_errors index) that belongs to a page name.Are all pages valid, is the requested page valid? ($prev, $next)Find the previous and the next element of the current element.Sets the error flags of all pages.of one page, or array of page names. The default of an empty string means all pages.If you override some page_values in Init() you have to update the page validation flags.$selected$lastviewedfindPosition()Saves the number of the selected Page to $this->selectedfindSelected()findSelected() searches the ID of the requested page. findPosition()tests wheter the user is allowed to see the requested page or ifhe should get rejected.Find the page that was gets shown next.form_errorpage_id => nameReturns an array with the names of all pages.Add a page to the assistantIf set to "strict" the user must complete a form before he gets to thenext tab. If set to "weak" he's free to switch between the tabs.In both cases he's not allowed to finish the assistant beforeall forms/tabs that are not declared as optional are without errorsSets the "switching mode"."assistant"PHPLIB persistance helper, name of this class.array("page_errors", "page_values", "lastviewed")PHPLIB persistance helper, list of persistant "slots".array()- must be restored by a session! -Array with status (isValid()) information of each page.- must be restored by a session! -Which page was shown last?-1Which page was selected by the user?-1Which page will be show now?""Template object.""Path to the template files."remove"How to handle unknowns.array( "main" => "assistant_main.tpl" #"tabs" => "assistant_tabs.html" )setTemplateFiles()Template files."strict"setMode()"switching mode""assistant"Nameprefix of all buttons generated by assistant.""get()findPosition()Flag, set if specials.initgetresetbuttongetbuttongettabissethttpxvarisfinishpressedisexitpressedishelppressedsethelpsetexitbuttonsetfinishbuttonshowtabssetstartsetmethodgetstartstartsetfinishgetfinishfinisharrayregexpkeysearchsetlabelsgetpagevaluesgetpagevalueswithtranslatednamesintrospection$page_values$pages$finish_button$exit$help$method$form_start$form_end$show_tabs$labels$show_prevnext$cr_html$exceptionspanemanagerform_commonobjectform_commonobject