ความรู้เบื้องต้น สอน การพัฒนา Mod PHPBB3

[modtanoy_pen]

การทำงานของ phpbb จะมี 2 ส่วนคือ ส่วนของหน้า web และในส่วนของ admin
ในส่วนของหน้า web จะทำงานเป็นfile โดยสร้าง file ขึ้นมา 1 file แล้วทำงานให้จบในfile เดียวโดยการสร้าง mode ในการเข้าถึง
และในส่วนของ admin จะมีการสร้าง class ขึ้นมาและสร้าง mode ในการเข้าถึงโดยการทำงานจะไม่มี file
การเข้าใช้งานในส่วนของ admin ใน phpbb นั้นจะมีการเข้ารหัส 2 ครั้ง
ในการสร้าง module ต้องมี
-Template
- File ทำงาน .php
- Info ของ module
- File ภาษา
Info มีไว้สำหรับระบุชื่อ file มี title , version,ฟังก์ชั่น install,uninstall
ในส่วนของ admin การสร้าง file ต่างๆจะถูกเก็บไว้ที่ acp เช่นในส่วนของ include/acp
และในส่วนของ template จะเก็บไว้ที่ adm/style
ในส่วนของหน้าเว็บจะเก็บไว้ข้างนอก

[modtanoy_pen]

การสร้างไฟล์ภาษา
การสร้างไฟล์ภาษาแต่ละ page จะต้องตั้งชื่อให้เหมือน page ที่เราจะสร้างประโยชน์ของการสร้างไฟล์ภาษานั้นคือเพื่อการใช้งานระบบได้หลายภาษาเช่น ภาษาไทย, ภาษาอังกฤษ ขึ้นอยู่ว่าผู้ใช้ใช้ภาษาอะไร โดยที่เราไม่ต้องสร้างเว็บหลายภาษา

ตัวอย่างการสร้างไฟล์ภาษา

โค้ด: เลือกทั้งหมด

<?php
/**
*
* about.php [Thai]  //ชื่อ page ที่เราสร้าง
*
* @package language
* @version $Id: $
* @copyright (c) 2011 phpBB Group
* @author 2011-04-18 - phpBBThailand.com//สร้างโดย
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
*/

/**
* DO NOT CHANGE
*/
if (!defined('IN_PHPBB'))
{
    exit;
}

if (empty($lang) || !is_array($lang))
{
    $lang = array();
}
$lang = array_merge($lang, array(
    'AB_MY_ABOUT'    => 'ทดอบสอบหน้าที่สร้างเอง',//การตั้งชื่อควรเป็นตัวใหญ่เพื่อไม่ให้มีการซ้ากับคำอื่นเราควรใช้ตัวย่อของชื่อ file ที่เราสร้างใส่ไว้ข้างหน้าตัวอย่างคือเราสร้างชื่อfile ว่า about เราจะใส่ AB_ ไว้ข้างหน้า
        'AB_MY_ABOUT2'  => 'ทดอบสอบหน้าที่สร้างเอง 2 '
    
));    
?> 

การเก็บ file ภาษาถ้าเป็นของหน้าเว็บจัดก็บไว้ที่ folder
language/folderภาษา
เช่น

โค้ด: เลือกทั้งหมด

language/en/ชื่อไฟล์ภาษา.php
language/th/ชื่อไฟล์ภาษา.php

ภาษาที่เราสร้างถ้าเป็นในส่วนของ admin จะเก็บไว้ที่
language/folder ภาษาที่เราสร้าง/folder acp
เช่น

โค้ด: เลือกทั้งหมด

language/en/acp/ชื่อไฟล์ภาษา.php
language/th/acp/ชื่อไฟล์ภาษา.php

[modtanoy_pen]

การเรียกใช้งานไฟล์ภาษา
ก่อนที่เราจะใช้ file ภาษาที่เราจะสร้างจะต้องทำการ register file ที่เราสร้างลง file php ที่เราทำงานก่อน ตัวอย่าง fileภาษาที่เราสร้างชื่อ about.php แต่เวลาเรียกใช้ไม่ต้องมีนามสกุล โดยใช้คำสั่ง add_lang('ชื่อ file ภาษาที่เราสร้างโดยไม่ต้องใส่นามสกุล')
ตัวอย่าง การ register file ภาษาที่สร้าง

โค้ด: เลือกทั้งหมด

<?php
define('IN_PHPBB', true);
$phpbb_root_path = (defined('PHPBB_ROOT_PATH')) ? PHPBB_ROOT_PATH : './';
$phpEx = substr(strrchr(__FILE__, '.'), 1);
include($phpbb_root_path . 'common.' . $phpEx);

// Start session management
$user->session_begin();
$auth->acl($user->data);
$user->setup();

$user->add_lang('about');//การ register file ภาษาที่เราสร้าง

page_header('About Us ---------------');


// trigger_error('NO_TOPIC');
    

$template->assign_vars(array(
    'CTIME'=> date('Y-m-d H:i:s') .' Hi',
        'AB_MY_ABOUT2'=> $user->lang['AB_MY_ABOUT2'],//กำหนดค่าตัวแปรภาษา
));

$template->set_filenames(array(
    'body' => 'about.html',
));

make_jumpbox(append_sid("{$phpbb_root_path}viewforum.$phpEx"));
page_footer();
?>

ตัวอย่าง การใช้งานภาษาที่สร้าง
การเรียกใช้มี 2 แบบคือ 1. เรียกใช้ที่หน้า template ตัวอย่างการเรียกใช้งาน {L_AB_MY_ABOUT} L_ คือตัวย่อของ Language การเรียกใช้ภาษาโดยตรงที่หน้า template จะต้องใส่ L_ ตามด้วยตัวแปลภาษาที่เราสร้างไว้
2.เรียกใช้ผ่านตัวแปลที่กำหนดไว้ที่หน้าทำงาน (.php ตัวอย่างด้านบน) ตัวอย่างการเรียกใช้งาน {AB_MY_ABOUT2} เรียกใช้ได้เลยโดยไม่ต้องมีตัว L ด้านหน้า

โค้ด: เลือกทั้งหมด

<!-- INCLUDE overall_header.html -->
about.html
<h2> ---
    {L_AB_MY_ABOUT}    
    -----
</h2>

{AB_MY_ABOUT2}

{L_ATTACHED_IMAGE_NOT_IMAGE} 
<h2>About Us -{CTIME}</h2>
<div class="panel">
   <div class="inner"><span class="corners-top"><span></span></span>

   <div class="content">
      <p>
         We were founded this year to bring you the best forum on the Internet!
         
         We promise to do the following:
         <ul>
            <li>Provide new content</li>
            <li>provide a friendly atmosphere</li>
            <li>Provide an environment where you can have fun!</li>
         </ul>
      </p>
   </div>

   <span class="corners-bottom"><span></span></span></div>
</div>

<!-- INCLUDE jumpbox.html -->
<!-- INCLUDE overall_footer.html -->

[modtanoy_pen]

Themplate

ค่าคงที่ของ themplate
T_THEME_PATH เก็บ css ./styles/prosilver/theme
T_TEMPLATE_PATH เก็บ folder template ./styles/prosilver/template
T_IMAGESET_PATH เก็บรูปภาพ css ./styles/prosilver/imageset
T_IMAGESET_LANG_PATH เก็บรูปภาพภาษา ./styles/prosilver/imageset/en
T_IMAGES_PATH เก็บรูปข้างนอก ./images/
T_SMILIES_PATH เก็บรูปยิ้ม ./images/smilies/
T_AVATAR_PATH เก็บสัญญาลักษณ์หน้าตัวเองเป็นรูปการ์ตูน ./images/smilies/

[modtanoy_pen]

การวนลูปส่งค่าไปให้ Themplate เพื่อการทำ list ข้อมูล
ใช้คำสั่ง assign_block_vars
ตัวอย่าง

โค้ด: เลือกทั้งหมด

while ($row = $db->sql_fetchrow($result))
{
    $template->assign_block_vars('loopname', array(
        'FOO' => $row['foo'],
        'BAR' => $row['bar']
    ));
}

ตัวอย่างลูปซ้อนลูป

โค้ด: เลือกทั้งหมด

while ($topic = $db->sql_fetchrow($result))
{
    $template->assign_block_vars('topic', array(
        'TOPIC_ID' => $topic['topic_id']
    ));

    while ($post = $db->sql_fetchrow($result))
    {
        $template->assign_block_vars('topic.post', array(
            'POST_ID' => $post['post_id']
        ));
    }
}

[modtanoy_pen]

การใช้ IF , ELSEIF ใน Themplate
ตัวอย่างการใช้ IF

โค้ด: เลือกทั้งหมด

<!-- IF expr -->
markup
<!-- ENDIF -->

ตัวอย่างการใช้ IF แบบลูป

โค้ด: เลือกทั้งหมด

<!-- IF loop.S_ROW_COUNT is even -->
markup
<!-- ENDIF -->

ตัวอย่างการใช้ ELSEIF

โค้ด: เลือกทั้งหมด

!-- IF expr1 -->
markup
<!-- ELSEIF expr2 -->
markup
.
.
.
<!-- ELSEIF exprN -->
markup
<!-- ELSE -->
markup
<!-- ENDIF -->

ตัวอย่าง การวนลูปใน Table การสลับสีของตาราง

โค้ด: เลือกทั้งหมด

<table>
<!-- IF loop.S_ROW_COUNT is even -->
<tr class="row1">
<!-- ELSE -->
<tr class="row2">
<!-- ENDIF -->
<td>HELLO!</td>
</tr>
</table>

โค้ด: เลือกทั้งหมด

<table>
<!-- IF loop.S_ROW_COUNT > 10 -->
<tr bgcolor="#FF0000">
<!-- ELSEIF loop.S_ROW_COUNT > 5 -->
<tr bgcolor="#00FF00">
<!-- ELSEIF loop.S_ROW_COUNT > 2 -->
<tr bgcolor="#0000FF">
<!-- ELSE -->
<tr bgcolor="#FF00FF">
<!-- ENDIF -->
<td>hello!</td>
</tr>
</table>

[M008]

คำสั่งเชื่อมต่อไฟล์

โค้ด: เลือกทั้งหมด

<!-- INCLUDE filename -->

การเขียนปิด tags การรวม PHP ใน template

โค้ด: เลือกทั้งหมด

<!-- PHP -->
echo "hello!";
<!-- ENDPHP -->

ข้อจำกัดในการกำหนด keyword
-- จะต้องเว้นวรรคทั้งก่อนและหลัง "=" เสมอ
-- เมื่อมีการกำหนด strings จะต้องใช้ single quotes
ตัวอย่าง

โค้ด: เลือกทั้งหมด

<!-- DEFINE $COLSPAN = 3 --> 
<!-- DEFINE $CLASS = 'class1' --> 

[M004]

ตัวอย่างการใช้งาน sql in set

โค้ด: เลือกทั้งหมด

$sql = 'UPDATE ' . MOD_DICTIONARY_TOPICE_TABLE . ' SET ' . $db->sql_build_array('UPDATE', array(
                            'topics_id'        => $cbItems_array,
                            )   
                        ) . ' WHERE ' . $db->sql_in_set('dictionary_id', $Id);
                        
                        $sql_query = $db->sql_query($sql);

                        $template->assign_vars(array(
                         'SAVE_EDIT_DATA'   =>  $user->lang['DIC_EDIT_SAVE'],
                          )  ); 

การใช้งาน sql in set คือการนำค่าที่อยู่ในรูป array มา query

[M004]

การใช้งาน sql escape

โค้ด: เลือกทั้งหมด

 
                 $sql_array = array(
                'SELECT'    => 'm.*,u.*',

                'FROM'      => array(
                    MOD_DICTIONARY_TABLE => 'm',
                    USERS_TABLE    => 'u'
                ),
                'WHERE'     =>  'm.user_id_add = u.user_id '
                 . " AND esearch LIKE '%".$db->sql_escape("$searchdic")."%' "
                 . ' AND ' . $db->sql_in_set('id', $markid )
                 . ' order by esearch asc'
                 );  
 

[M004]

ตัวการใช้งาน sql query limit (แบ่งหน้า ข้อมูลที่จะแสดง)

23.jpg (6.1 KiB) Viewed 1629 times

โค้ด: เลือกทั้งหมด

$start   = request_var('start', 0);
                $limit  = 2;
                $pagination_url = $this->u_action.'&action=select_add';   
                
                $sql = "SELECT * FROM " . TOPICS_TABLE . " where topic_title LIKE '%".$db->sql_escape("$search")."%' " ;
                $result = $db->sql_query($sql);
                $result_row = $db->sql_query_limit($sql, $limit, $start);
                 while ($data_row = $db->sql_fetchrow($result_row))
                 {
                   $template->assign_block_vars('data_row', array(
                        'TOPIC_ID' => $data_row['topic_id'],
                        'TOPIC_TITLE' => $data_row['topic_title'],
                     ));
                  
                 } 
                
                if(empty($search)){
                   $post['search'] = '';
                   $error['search']  = $user->lang['ERROR_SEARCH'];
                } 
                if(empty($nameeg)){
                   $post['nameeg'] = '';
                   $error['nameeg']  = $user->lang['ERROR_SEARCH'];
                }
                if(empty($nameth)){
                   $post['nameth'] = '';
                   $error['nameth']  = $user->lang['ERROR_SEARCH'];
                }
                if(empty($detailth)){
                   $post['detailth'] = '';
                   $error['detailth']  = $user->lang['ERROR_SEARCH'];
                }
                 
                 $template->assign_vars(array(
                        'DATA_SEARCH'   =>  $post['search'],
                        'DATA_NAMEEG'   =>  $post['nameeg'],
                        'DATA_NAMETH'   =>  $post['nameth'],
                        'DATA_DETAILTH' =>  $post['detailth'],
                        'DATA_APPROVE'  =>  $post['APPROVE'],
                        
                        'ERROR_SEARCH'      =>  $error['search'],
                        'ERROR_NAMEEG'      =>  $error['nameeg'],
                        'ERROR_NAMETH'      =>  $error['nameth'],
                        'ERROR_DETAILTH'    =>  $error['detailth'],
                        'MARK'              =>  $error['markid'],
                        'ACCTION'           =>  $this->u_action, 
                ));
                 
                 $db->sql_freeresult($result_row);
                $sql = 'SELECT COUNT(*) as total_data FROM ' . TOPICS_TABLE . " where topic_title LIKE '%".$db->sql_escape("$search")."%' " ;
                $result = $db->sql_query($sql);
                $total_data = $db->sql_fetchfield('total_data');
                $db->sql_freeresult($result);
                
                $template->assign_vars(array(
                    'PAGINATION'        => generate_pagination($pagination_url, $total_data, $limit, $start),
                    'PAGE_NUMBER'       => on_page($total_data, $limit, $start),
                ));  

กรณี มีค่าที่ต้องการให้ คงอยู่ส่งไปหน้าใหม่ด้วย ตัวแปล $pagination_url ใส่ค่าที่เคยเลือกหรอกรอกไว้ลงไปในตัวแปลด้วย
เช่น

โค้ด: เลือกทั้งหมด

$pagination_url .='&q=ค่าที่ส่งมา&str=ค่าที่ส่งมา';

ค่าที่เป็น array

โค้ด: เลือกทั้งหมด

$pagination_url .='&q[0]=ค่า1&q[1]=ค่า2';