檢視 Etable/開發的原始碼

[[分類:Etable]]
PHP是否允許已在的類別或物件再增添新方法，待查。

可參考[http://blog.roodo.com/rocksaying/archives/2884871.html 混成]
==使用由工作函式定義之函數==
===batch===
*batch屬性為陣列，每一元素之索引為按鈕提示，每一元素之名函式名。
*諸函式在前置處理時執行。
*範例：
*#$物件->sql[0]="select 數欄,concat('<input type=text name=ba[',id欄,'][表單欄1] value=',表單欄1,' >') 欄代名,concat('<input type=text name=ba[',id欄,'][表單欄2] value=',表單欄2,' >') 欄代名 from 諸表 where 條件";
*#$物件->batch=array('按鈕提示'=>'函式名');
*#添函式：
<pre>function 函式名(){
	if(isset($_REQUEST['ba'])){
		foreach($_REQUEST['ba'] as $k=>$v){
			$up_sql="update 表 set";
			$up_col=array();
			foreach($v as $kk=>$vv){
				if($vv!=''){$up_col[]="`".$kk."`='".etable::quoteSmart($vv,'-addslashes')."'";}// MySQL處理欄值會去反斜，所以先加反斜
				else{$up_col[]="`".$kk."`=''";}
			}
			$up_sql.=implode(",",$up_col)." where id欄='".$k."'";
			mysql_query($up_sql);
		}
		echo '寫好了';
	}
}</pre>

===banE===
*範例：
*#設 $物件->banE='函式名';
*#添函式：
<pre>function 函式名($row){
	if(!in_array($_SESSION['login_user'],explode(';',$row[幾]))){
		$row['banEdit']=1;
		$row['banErase']=1;
	}
	return $row;
}</pre>

===以函式決定欄值的表現===
*在工作程式中對 formType 增加一元素 '長欄名'=>array('function',函式名)
*定義函式，傳回值用來取代該欄的欄值並顯示於輸出。
*範例：
*#設 $物件->formType=array('長欄名'=>array('function',函式名));
*#添函式：
<pre>function 函式名($arr){
	if($arr['row'][3]==$_SESSION['login_user']){return $arr['value'];}
	else{return '無權看';}
}</pre>

==對編刪連結產生限制 banE==
*在工作程式中定義一個判別函式 xxx($row) ，引數為 $row 並使用 $_SESSION ，return 回來含兩個變數 $row['banEdit'],$row['banErase'] 的新 $row 。
*增添 $物件->banE='函式名' ，函式名指的是上項的那個函式，如 'xxx' 。
*在 etable.php 的 mk_rows 方法中，加入「if(isset($this->banE) && $this->banE){$temp=$this->banE;$row=$temp($row);}」，然後將 $row 放入 $this->tbl 。
*各種顯示方法共用「編、刪連結生成函式 up_links($row)」，其中會由 $row['banEdit'],$row['banErase'] 的值判斷要不要抑制編、刪連結連結。

==求欄值==
etable.php 中的 colValue(欄序,$value,$row) 以欄序逐一處理。
#text欄或bolb欄
#*欄值為二進位內容，並不秀出內容，而是秀出提示
#*若formType指示為 'auto' 欄，並包含使用 wiki 語法，顯示$wiki->wiki2html($value)
#*flag未帶binary或演算式者為text欄，進一步判讀是否為HTML格式
#若formType指示為 'unix_time' 欄，則依格式指示顯示
#若formType指示為 'oneWaySwitch' 欄，則秀按鈕
#若為連動選單的第二選單：秀提示或'------'
#若formType指示為 'function' 欄，取出函式名，執行函式(引數為$j,$value,$row)，秀函式傳回值。
#交代要轉成提示者：
#*排除'unix_time' 欄
#*若formType指示為 'select' 或 'select2' 或 'radio' 欄，依欄值秀出相應提示。
#*若formType指示為 'radioyn' 欄，依欄值真假秀出相應提示。
#*若formType指示為 'checkbox' 欄，依欄值秀出相應提示。
#*若formType指示為 'wrap' 欄，$value中的「;」代換為換行&lt;br/&gt;
#轉換數學公式 mimetex($value)

==欄位種類==
派值範例：<pre>  $formType=array('長欄名'=&gt;array('select',array('值'=&gt;'提示文字','值'=&gt;'提示文字','值'=&gt;'提示文字',…)),
                  '長欄名'=&gt;array('select2',第一選單陣列,第二選單長欄名,第二選單二維陣列,第二選單以提示代表欄值),
                  '長欄名'=&gt;array('select22',array(0=&gt;'===請選擇===')),
                  '長欄名'=&gt;array('radio' ,array('值'=&gt;'提示文字','值'=&gt;'提示文字','值'=&gt;'提示文字',…)),
                  '長欄名'=&gt;array('radioyn',array('0之提示','1之提示')),
                  '長欄名'=&gt;array('checkbox',array('勾選後送值'=&gt;'提示')),
                  '長欄名'=&gt;array('date',array('ifFormat'=&gt;'daFormat')),改畢，因欄值'%Y-%m-%d'是小日曆認得的格式，所以預選日期為欄值日期
                  '長欄名'=&gt;array('auto',array('plain','html','wiki','tex')),改畢，$this-&gt;formType中未定義，則$this-&gt;fields[$i]['formType']會自動將該欄定為auto型，如欄型為TEXT則form出textarea，其他出文字欄。第二元素為語法組合陣列，預設為plain(純文本)，要wiki型，欄型須為TEXT，該改。
                  '長欄名'=&gt;array('hidden',函式名,表單元素出現時機),
                  '長欄名'=&gt;array('unix_time','Y-m-d&lt;bR&gt;H:i:s',表單元素出現時機),待改，因欄值'%s'是小日曆不認得的格式，所以預選日期為跑到當天日期，要認得欄值格式須為「年-月-日 [10] 時:分」，用Calendar.setDateFormat('%s');無效。此事無解，參看http://192.168.3.175/et/class/calendar/jstest.htm，不是每一種格式jscalendar都可以認得出日期，如Date #0:的%s會解不出日期，Date #2:的…會解錯日期，Date #4:解不出日期。
                  '長欄名'=&gt;array('oneWaySwitch',array(0=&gt;'按鈕字',值=&gt;'按完字')),
                  '長欄名'=&gt;array('searchSelect',array(''=&gt;'===輸入提示===')),
                  '長欄名'=&gt;array('function',函式名),
                  '長欄名'=&gt;array('wrap'),
                  );</pre>

===函式欄===
表示法如派值範例。

函式寫在工作程式中，以欄值為唯一引數。

若未設定翻譯，秀原欄值；若設定翻譯，秀函式返回值。

===searchSelect 欄===
====配合的表單元件====
*formcatchtext.php：產生文字輸入區，沒name沒id，但可決定回應要從那一個id當中冒出來。
*formselect-et.php：產生span包select或單純的select
*#XoopsFormSelect方法增加最後一個引數：$asSpan，預設為0
*#render方法依$asSpan的值決定select外面要不要加span，以及id要派給外層span還是內層的select
*#如果沒有設 id ，以name為id。

==表單==
===諸方法===
*overPageXoopsForm，將$overPage陣列轉成XoopsForm的隱藏元素
*form_same，插、編表單共同部分：$overPage、後送按鈕
*form_edit，編表單
*#剔除演算式且沒有代名者，演算式出Label
*#hidden處理
*#unix_time的hidden處理
*#其他各欄，使用addElements方法處理
*#form_same
*addElements，先分 formType 有交代及 formType 沒交代 
**formType 有交代者：
**#排除hidden
**#unix_time的非hidden處理
**#date
**#select
**#searchSelect
**#select2
**#radio
**#checkbox
**#radioyn
**#auto，出文字區塊
**#其他如 function ，出文字欄
**formType 沒交代者：
**#blob且binary，出Label
**#blob非binary，出文字區塊
**#其他出文字欄