class.tx_install.php File Reference

Go to the source code of this file.

Namespaces
namespace	TYPO3
Classes
class	tx_install
Functions
	getItemArrayType ($arr)
	Private.
	getItemBlobSize ($len)
	Private.
	suggestTCAFieldDefinition ($fieldName, $fieldInfo)
	Should suggest a TCA configuration for a specific field.
	includeTCA ()
	Includes TCA.
	linkIt ($url, $link="")
	This creates a link to the given $url.
	message ($head, $short_string="", $long_string="", $type=0, $force=0)
	Setting a message in the message-log and sets the fatalError flag if error type is 3.
	printSection ($head, $short_string, $long_string, $type)
	This "prints" a section with a message to the ->sections array.
	fw ($str, $size=1)
	Wraps the str in a font-tag with verdana 1.
	fwheader ($str)
	Wraps the str in a font-tag with verdana 1.
	wrapInCells ($label, $content)
	Wrapping labal/content in a table-row.
	printAll ()
	This prints all the messages in the ->section array.
	outputWrapper ($content)
	This wraps and returns the main content of the page into proper html-code.
	menu ()
	[Describe function...]
	stepHeader ()
	[Describe function...]
	note123 ()
	[Describe function...]
	endNotes ()
	[Describe function...]
	convertByteSize ($bytes)
	[Describe function...]
	securityRisk ()
	[Describe function...]
	alterPasswordForm ()
	[Describe function...]
	messageBasicFinished ()
	[Describe function...]
	setScriptName ($type)
	[Describe function...]
	formWidth ($size=48, $textarea=0, $styleOverride="")
	[Describe function...]
	formWidthText ($size=48, $styleOverride="", $wrap="")
	[Describe function...]

---

Function Documentation

alterPasswordForm (   )

[Describe function...] Returns: [type] ... Definition at line 4605 of file class.tx_install.php. References $content. { $content = '<form action="'.$this->scriptSelf.'?TYPO3_INSTALL[type]=extConfig" method="POST"> Enter new password: <input type="password" name="TYPO3_INSTALL[extConfig][BE][installToolPassword]"><BR>Enter again: <input type="password" name="installToolPassword_check"> <input type="hidden" name="installToolPassword_md5" value=1> <input type="submit" value="Set new password"><br> </form>'; return $content; }

convertByteSize (  $  bytes  )

[Describe function...] Parameters: [type]  $bytes: ... Returns: [type] ... Definition at line 4573 of file class.tx_install.php. Referenced by tx_install::checkConfiguration(). { if (stristr($bytes,"m")) { $bytes=doubleval($bytes)*1024*1024; } elseif (stristr($bytes,"k")) { $bytes=doubleval($bytes)*1024; } return $bytes; }

endNotes (   )

[Describe function...] Returns: [type] ... Definition at line 4554 of file class.tx_install.php. References fw(). { if ($this->mode!="123" && $this->passwordOK) { $c.="OS detected: <strong>".(TYPO3_OS=="WIN"?"WIN":"UNIX")."</strong><BR>"; $c.="UNIX/CGI detected: <strong>".(php_sapi_name()=="cgi" ? "YES" : "NO")."</strong><BR>"; $c.="PATH_thisScript: <strong>".PATH_thisScript."</strong><BR>"; $c.="<BR>"; $c.="<a href='../index.php' target='install_backend'>Backend admin in new window.</a><BR>"; $c.="<a href='../../index.php' target='install_frontend'>Frontend website in new window.</a><BR>"; return $this->fw($c); } }

formWidth (  $  size = 48, $  textarea = 0, $  styleOverride = "" )

[Describe function...] Parameters: [type]  $size: ... [type]  $textarea: ... [type]  $styleOverride: ... Returns: [type] ... Definition at line 4656 of file class.tx_install.php. { // Input or text-field attribute (size or cols) $wAttrib = $textarea?"cols":"size"; if (!$GLOBALS["CLIENT"]["FORMSTYLE"]) { // If not setting the width by style-attribute $size = ceil($size*1); $retVal = ' '.$wAttrib.'="'.$size.'"'; } else { // Setting width by style-attribute. "cols" MUST be avoided with NN6+ $pixels = ceil($size*10); $retVal = $styleOverride ? ' style="'.$styleOverride.'"' : ' style="width:'.$pixels.'px;"'; } return $retVal; }

formWidthText (  $  size = 48, $  styleOverride = "", $  wrap = "" )

[Describe function...] Parameters: [type]  $size: ... [type]  $styleOverride: ... [type]  $wrap: ... Returns: [type] ... Definition at line 4677 of file class.tx_install.php. References formWidth(). { $wTags = $this->formWidth($size,1,$styleOverride); // Netscape 6+ seems to have this ODD problem where there WILL ALWAYS be wrapping with the cols-attribute set and NEVER without the col-attribute... if (strtolower(trim($wrap))!="off" && $GLOBALS["CLIENT"]["BROWSER"]=="net" && $GLOBALS["CLIENT"]["VERSION"]>=5) { $wTags.=' cols="'.$size.'"'; } return $wTags; }

fw (  $  str, $  size = 1 )

Wraps the str in a font-tag with verdana 1. Parameters: [type]  $str: ... [type]  $size: ... Returns: [type] ... Definition at line 4371 of file class.tx_install.php. { if ($GLOBALS["CLIENT"]["SYSTEM"]=="unix" && $GLOBALS["CLIENT"]["BROWSER"]=="konqu") { return '<font face="sans-serif" size='.($size+2).' color=black>'.$str.'</font>'; } return '<font face="verdana,sans-serif" size='.$size.' color=black>'.$str.'</font>'; }

fwheader (  $  str  )

Wraps the str in a font-tag with verdana 1. Parameters: [type]  $str: ... Returns: [type] ... Definition at line 4384 of file class.tx_install.php. { return '<div align=center><strong>'.$this->fw($str,3).'</strong></div>'; }

getItemArrayType (  $  arr  )

Private. Parameters: [type]  $arr: ... Returns: [type] ... Definition at line 4076 of file class.tx_install.php. References $out. Referenced by tx_install::suggestFieldDefinition(). { if (is_array($arr)) { reset($arr); $type[]=0; $intSize[]=0; while(list(,$item)=each($arr)) { if (!t3lib_div::testInt($item[1]) && $item[1]!="--div--") { $type[]=strlen($item[1]); } else { $intSize[]=$item[1]; } } $us = min($intSize)>=0 ? " unsigned" : ""; if (max($type)>0) { $out = "varchar(".max($type).") NOT NULL default ''"; } elseif (max($intSize)>(!$us?127:255)) { $out = "int(11)".$us." NOT NULL default '0'"; } else { $out = "tinyint(3)".$us." NOT NULL default '0'"; } } return $out; }

getItemBlobSize (  $  len  )

Private. Parameters: [type]  $len: ... Returns: [type] ... Definition at line 4106 of file class.tx_install.php. Referenced by tx_install::suggestFieldDefinition(). { return ($len>255 ? "tiny" : "")."blob NOT NULL"; }

includeTCA (   )

Includes TCA. Returns: [type] ... Definition at line 4260 of file class.tx_install.php. References PATH_t3lib, PATH_typo3conf, and TYPO3_tables_script. Referenced by tx_install::checkTheDatabase(). { global $TCA; include (TYPO3_tables_script ? PATH_typo3conf.TYPO3_tables_script : PATH_t3lib."stddb/tables.php"); // Extension additions if ($GLOBALS["TYPO3_LOADED_EXT"]["_CACHEFILE"]) { include(PATH_typo3conf.$GLOBALS["TYPO3_LOADED_EXT"]["_CACHEFILE"]."_ext_tables.php"); } else { include(PATH_t3lib."stddb/load_ext_tables.php"); } if (TYPO3_extTableDef_script) { include (PATH_typo3conf.TYPO3_extTableDef_script); } reset($TCA); while(list($table)=each($TCA)) { t3lib_div::loadTCA($table); } }

linkIt (  $  url, $  link = "" )

This creates a link to the given $url. If $link is set, that'll be the link-text Parameters: [type]  $url: ... [type]  $link: ... Returns: [type] ... Definition at line 4302 of file class.tx_install.php. { return '<a href="'.$url.'" target="_blank">'.($link?$link:$url).'</a>'; }

menu (   )

[Describe function...] Returns: [type] ... Definition at line 4476 of file class.tx_install.php. References $out, and table(). Referenced by SC_alt_doc::compileForm(), getDynTabMenu(), t3lib_BEfunc::getModuleData(), tx_cms_layout::getTableMenu(), getTabMenuRaw(), tx_funcwizards_webfunc::main(), SC_mod_tools_em_index::main(), SC_alt_topmenu_dummy::main(), SC_alt_menu_sel::main(), SC_alt_menu::main(), localFolderTree::SC_browse_links::main_rte(), t3lib_superadmin::make(), tslib_imgmenu::makeImageMap(), SC_db_layout::menuConfig(), t3lib_SCbase::menuConfig(), tx_funcwizards_webfunc::modMenu(), outputWrapper(), tslib_pibase::pi_list_modeSelector(), tslib_menu::start(), tx_cms_layout::tt_content_drawItem(), and SC_db_new_content_el::wizardArray(). { if (!$this->passwordOK) return; reset($this->menuitems); $c=0; $out=array(); while(list($k,$v)=each($this->menuitems)) { $bgColor = ($this->INSTALL["type"]==$k ? ' bgColor="#ABBBB4"' : ' bgColor="#F4F0E8"'); $c++; $out[]='<tr><td'.$bgColor.'><a href="'.$this->scriptSelf.'?TYPO3_INSTALL[type]='.$k.($this->mode?"&mode=".rawurlencode($this->mode):"").'">'.$this->fw($c.': '.$v).'</a></td></tr>'; } $code = '<table border=0 cellpadding=0 cellspacing=1>'.implode($out,chr(10)).'</table>'; $code = '<table border=0 cellpadding=0 cellspacing=0 bgColor="#ABBBB4"><tr><td>'.$code.'</td></tr></table>'; return '<div align="center">'.$code.'</div>'; }

message (  $  head, $  short_string = "", $  long_string = "", $  type = 0, $  force = 0 )

Setting a message in the message-log and sets the fatalError flag if error type is 3. Definition at line 4309 of file class.tx_install.php. References printSection(). Referenced by t3lib_htmlmail::add_message(), t3lib_readmail::analyseReturnError(), tx_install::checkConfiguration(), tx_install::checkDirs(), tx_install::checkExtensions(), tx_install::checkImageMagick(), tx_install::checkPassword(), tx_install::checkTheDatabase(), tx_install::checkTheImageProcessing(), tx_install::cleanupManager(), t3lib_dmailer::dmailer_sendAdvanced(), t3lib_dmailer::dmailer_setBeginEnd(), tx_install::generateConfigForm(), tx_cms_layout::getTable_sys_note(), tx_install::getTwinImageMessage(), tx_install::init(), tx_install::isBasicComplete(), tx_install::isExtensionEnabled(), tx_install::phpinformation(), t3lib_htmlmail::setContent(), tslib_fe::tempPageCacheContent(), tx_install::tx_install(), tx_install::typo3conf_edit(), and tx_install::typo3TempManager(). { // type: -1=OK sign, 0=message, 1=notification, 2=warning , 3=error if (!$force && $this->mode=="123" && $type<2) {return;} // Return directly if mode-123 is enabled. if ($type==3) {$this->fatalError=1;} if ($this->messageFunc_nl2br) { $long_string = nl2br(trim($long_string)); } else { $long_string = trim($long_string); } if (!$this->silent) $this->printSection($head, $short_string, $long_string, $type); }

messageBasicFinished (   )

[Describe function...] Returns: [type] ... Definition at line 4621 of file class.tx_install.php. { $msg =" Apparently you have completed the basic setup of the TYPO3 database. Now you can choose between these options: - <a href='../../index.php'><strong>Go to the frontend pages</strong></a> - <a href='../index.php?u=admin&p=password'><strong>Go to the backend login</strong></a> (username may be: <i>admin</i>, password may be: <i>password</i>.) - <a href='".$this->scriptSelf."'><strong>Continue to configure TYPO3</strong></a> (Recommended). This will let you analyse and verify that everything in your PHP installation is alright. Also if you want to configure TYPO3 to use all the cool features, you <em>must</em> dig into the this! "; return $msg; }

note123 (   )

[Describe function...] Returns: [type] ... Definition at line 4540 of file class.tx_install.php. References table(). { if ($this->mode=="123") { $c='<table border=0 cellpadding=0 cellspacing=0 width=100%> <tr><td bgcolor=#D9D5C9 nowrap><img src="../t3lib/gfx/icon_note.gif" width=18 height=16 align=top><strong>'.$this->fontTag1.'NOTICE: Install Tool is running in \'123\' mode. <a href="'.$this->scriptSelf.'">Click here to disable.</a></font></strong></td></tr> </table>'; return $c; } }

outputWrapper (  $  content  )

This wraps and returns the main content of the page into proper html-code. Parameters: [type]  $content: ... Returns: [type] ... Definition at line 4423 of file class.tx_install.php. References $out, menu(), stepHeader(), and table(). Referenced by tx_install::checkPassword(), tx_install::checkTheDatabase(), tx_install::checkTheImageProcessing(), tx_install::cleanupManager(), tx_install::init(), tx_install::phpinformation(), tx_install::typo3conf_edit(), and tx_install::typo3TempManager(). { $out=' <html> <STYLE TYPE="text/css"> <!-- A:link {text-decoration: none} A:visited {text-decoration: none} A:active {text-decoration: none} A:hover {color: #000066} --> </STYLE> '.$this->headerStyle.' <head> <title>TYPO3 Install Tool</title> '.($this->JSmessage?' <script language="javascript" type="text/javascript">alert(unescape(\''.rawurlencode($this->JSmessage).'\'));</script> ':'').' </head> <body bgcolor="white" alink="maroon" link="maroon" vlink="maroon">'.$this->contentBeforeTable.' <div align="center"> <table border=0 cellspacing=0 cellpadding=0 width=333 bgcolor="white"> <tr> <td><img src="'.$this->backPath.'t3lib/gfx/typo3logo.gif" width=333 height=43 vspace=10 hspace=50></td> </tr> <tr> <td bgcolor="black"> <table width="100%" border=0 cellspacing=1 cellpadding=10> <tr> <td bgcolor=#F4F0E8> <font face="verdana,sans-serif" size=4 color=black><strong><div align="center">TYPO3 '.$GLOBALS["TYPO_VERSION"].' Install Tool</div></strong></font> <font face="verdana,sans-serif" size=2 color=navy><strong><div align="center">Site: '.$GLOBALS["TYPO3_CONF_VARS"]["SYS"]["sitename"].'</div></strong></font><br> '.($this->step?$this->stepHeader():$this->menu()).$content.'<HR>'.$this->note123().$this->endNotes().' </td> </tr> </table> </td> </tr> </table> </div> </body> </html>'; return $out; }

printAll (   )

This prints all the messages in the ->section array. Returns: [type] ... Definition at line 4404 of file class.tx_install.php. References $out, header(), and table(). Referenced by tx_install::init(). { reset($this->sections); $out=""; while(list($header,$valArray)=each($this->sections)) { $out.=' <tr><td>&nbsp;</td></tr> <tr><td><strong><div align="center">'.$this->fw($header.":",2).'</div></strong></td></tr> '; $out.=implode($valArray,chr(10)); } return '<table border=0 cellpadding=2 cellspacing=2>'.$out.'</table>'; }

printSection (  $  head, $  short_string, $  long_string, $  type )

This "prints" a section with a message to the ->sections array. Parameters: [type]  $head: ... [type]  $short_string: ... [type]  $long_string: ... [type]  $type: ... Returns: [type] ... Definition at line 4330 of file class.tx_install.php. Referenced by message(). { $icon=""; $bgCol =' bgcolor=#D9D5C9'; switch($type) { case "3": $bgCol =' bgcolor=red'; $icon = 't3lib/gfx/icon_fatalerror.gif'; break; case "2": // $bgCol =' bgcolor=#9BA1A8'; $icon = 't3lib/gfx/icon_warning.gif'; break; case "1": // $bgCol =' bgcolor=#ABBBB4'; $icon = 't3lib/gfx/icon_note.gif'; break; case "-1": // $bgCol =' bgcolor=yellow'; $icon = 't3lib/gfx/icon_ok.gif'; break; default: $bgCol =' bgcolor='.t3lib_div::modifyHTMLcolor("#ABBBB4",+40,+30,+40); break; } if (!trim($short_string)) { $this->sections[$head][]=""; } else { $this->sections[$head][]=' <tr><td'.$bgCol.' nowrap>'.($icon?'<img src="'.$this->backPath.$icon.'" width=18 height=16 align=top>':'').'<strong>'.$this->fw($short_string).'</strong></td></tr>'.(trim($long_string)?' <tr><td>'.$this->fw($long_string).'<BR><BR></td></tr>' : ''); } }

securityRisk (   )

[Describe function...] Returns: [type] ... Definition at line 4587 of file class.tx_install.php. { $c="This script is a <strong>great danger to the security of TYPO3</strong> if you don't secure it somehow. We suggest one of the following: - change the password as defined by the md5-hash in TYPO3_CONF_VARS[BE][installToolPassword]. - delete the folder 'typo3/install/' with this script in or just insert an 'exit;' line in the script-file there. - password protect the 'typo3/install/' folder, eg. with a .htaccess file The TYPO3_CONF_VARS[BE][installToolPassword] is always active, but choosing one of the other options will improve security and is recommended highly. "; return $c; }

setScriptName (  $  type  )

[Describe function...] Parameters: [type]  $type: ... Returns: [type] ... Definition at line 4643 of file class.tx_install.php. { $value = $this->scriptSelf."?TYPO3_INSTALL[type]=".$type.($this->mode?"&mode=".rawurlencode($this->mode):"").($this->step?"&step=".rawurlencode($this->step):""); return $value; }

stepHeader (   )

[Describe function...] Returns: [type] ... Definition at line 4498 of file class.tx_install.php. References $out. Referenced by outputWrapper(). { $msg1='Type in your database parameters here:'; $msg2='Database'; $msg3='Import the database sql-file'; $msg4='You\'re done!'; $out='<img src="../t3lib/gfx/123_'.$this->step.'.png" width="402" height="73" border="0" alt="" usemap="#id123_print_Map"> <MAP NAME="id123_print_Map"> <AREA title="'.$msg4.'" SHAPE="poly" ALT="" COORDS="299,35, 303,19, 313,9, 335,5, 366,6, 379,11, 388,21, 392,35, 390,47, 381,58, 376,64, 359,67, 320,66, 307,60, 302,51, 300,44" HREF="'.$this->scriptSelf.'?mode='.$this->mode.'&step=go"> <AREA title="'.$msg3.'" SHAPE="circle" ALT="" COORDS="234,36,32" HREF="'.$this->scriptSelf.'?mode='.$this->mode.'&step=3"> <AREA title="'.$msg2.'" SHAPE="circle" ALT="" COORDS="136,37,30" HREF="'.$this->scriptSelf.'?mode='.$this->mode.'&step=2"> <AREA title="'.$msg1.'" SHAPE="circle" ALT="" COORDS="40,36,29" HREF="'.$this->scriptSelf.'?mode='.$this->mode.'&step=1"> </MAP> <BR>'; $msg=""; switch(strtolower($this->step)) { case 1: $msg=$msg1; break; case 2: $msg=$msg2; break; case 3: $msg=$msg3; break; case "go": $msg=$msg4; break; default: break; } $out.='<BR><div align="center"><strong>'.$this->fw($msg,2).'</strong></div>'; return $out; }

suggestTCAFieldDefinition (  $  fieldName, $  fieldInfo )

Should suggest a TCA configuration for a specific field. Parameters: [type]  $fieldName: ... [type]  $fieldInfo: ... Returns: [type] ... Definition at line 4117 of file class.tx_install.php. References $out. Referenced by tx_install::compareDatabaseAndTCA(). { list($type,$len) = split(" |\(|\)",$fieldInfo,3); switch($type) { case "int": $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "input", "size" => "8", "max" => "20", "eval" => "date", "default" => "0", "checkbox" => "0" ) ), ----- OR ----- "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "select", "items" => Array ( Array("[nothing]", 0), Array("Extra choice! Only negative values here.", -1), Array("__Divider:__", "--div--") ), "foreign_table" => "[some_table_name]" ) ),'; break; case "varchar": if ($len>10) { $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "input", "size" => "8", "max" => "'.$len.'", "eval" => "trim", "default" => "" ) ),'; } else { $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "select", "items" => Array ( Array("Item number 1", "key1"), Array("Item number 2", "key2"), Array("-----", "--div--"), Array("Item number 3", "key3") ), "default" => "1" ) ),'; } break; case "tinyint": $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "select", "items" => Array ( Array("Item number 1", "1"), Array("Item number 2", "2"), Array("-----", "--div--"), Array("Item number 3", "3") ), "default" => "1" ) ), ----- OR ----- "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "check", "default" => "1" ) ),'; break; case "tinytext": $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "input", "size" => "40", "max" => "255", "eval" => "", "default" => "" ) ),'; break; case "text": case "mediumtext": $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "config" => Array ( "type" => "text", "cols" => "48", "rows" => "5" ) ),'; break; default: $out=' "'.$fieldName.'" => Array ( "label" => "'.strtoupper($fieldName).':", "exclude" => 0, "config" => Array ( "type" => "input", "size" => "30", "max" => "", "eval" => "", "default" => "" ) ),'; break; } return $out?$out:$fieldInfo; }

wrapInCells (  $  label, $  content )

Wrapping labal/content in a table-row. Parameters: [type]  $label: ... [type]  $content: ... Returns: [type] ... Definition at line 4395 of file class.tx_install.php. { return '<tr><td valign=top nowrap><strong>'.$this->fw($label).'</strong></td><td>&nbsp;</td><td valign=top>'.$this->fw($content).'<BR></td></tr>'; }

---