線上書籍

Home

Tad Tools 使用說明

use XoopsModules\Tadtools\Utility;

Utility 工具集是把之前 tadtools/function.php 所有常用的函式,都物件化而已。

  1. 常用 XOOPS表單安全檢查(配合表單token 使用) Utility::xoops_security_check()

     

  2. 常用 將陣列列出(除錯用,取代die(var_dump($arr))) Utility::dd($array = [])

     

  3. 常用 建立目錄 Utility::mk_dir($dir = '')

     

  4. 常用 自訂錯誤訊息 Utility::web_error($sql, $file = '', $line = '', $force = false)

     

  5. 常用 細部權限判斷 Utility::power_chk($perm_name = '', $perm_itemid = '', $module_id = '', $trueifadmin = true)

     

  6. 常用 亂數字串($format =[ 'ALL', 'CHAR', 'NUMBER']) Utility::randStr($len = 6, $format = 'ALL')

     

  7. 常用 取得分頁工具 Utility::getPageBar($sql = '', $show_num = 20, $page_list = 10, $to_page = '', $url_other = '', $bootstrap = '3', $g2p_name = 'none')

    常用範例

    //Utility::getPageBar($原sql語法, 每頁顯示幾筆資料, 最多顯示幾個頁數選項); $PageBar = Utility::getPageBar($sql, 20, 10); $bar = $PageBar['bar']; $sql = $PageBar['sql']; $total = $PageBar['total']; $xoopsTpl->assign('bar', $bar); $xoopsTpl->assign('total', $total);

     

  8. 常用 取得模組工具列($force為true時,$interface_menu 無論有無內容,都會呈現工具列) Utility::toolbar_bootstrap($interface_menu = [], $force = false)

     

  9. 一般 刪除目錄 Utility::delete_directory($dirname)

     

     

  10. 一般 拷貝目錄 Utility::full_copy($source = '', $target = '')

     

  11. 一般 路徑導覽,需搭配 get_模組_cate_path($分類編號); Utility::tad_breadcrumb($cate_sn = '0', $cate_path_array = [], $url_page = 'index.php', $page_cate_name = 'csn', $cate_title_name = 'title', $last = '')

    如:

    //取得路徑 function get_cate_path($csn = "", $sub = false) { global $xoopsDB; if (!$sub) { $home['首頁'] = XOOPS_URL . "/modules/tadgallery/index.php"; } else { $home = array(); } $sql = "select title, of_csn from " . $xoopsDB->prefix("tad_gallery_cate") . " where csn='{$csn}'"; $result = $xoopsDB->query($sql) or redirect_header($_SERVER['PHP_SELF'], 3, mysql_error()); list($title, $of_csn) = $xoopsDB->fetchRow($result); $opt_sub = (!empty($of_csn)) ? get_cate_path($of_csn, true) : ""; if (!empty($title)) { $opt[$title] = XOOPS_URL . "/modules/tadgallery/index.php?csn=$csn"; } if (is_array($opt_sub)) { $path = array_merge($home, $opt_sub, $opt); } elseif (is_array($opt)) { $path = array_merge($home, $opt); } else { $path = $home; } return $path; }

     

  12. 一般 設定頁面 meta 給FB、Line 等網站使用 Utility::setup_meta($title = '', $content = '', $image = '')

     

  13. 一般 產生HTML5頁面語法 Utility::html5($content = '', $ui = false, $bootstrap = true, $bootstrap_version = 3, $use_jquery = true, $container = 'container', $title = 'XOOPS', $head_code = '')

     

  14. 一般 將文字中的網址轉為連結 Utility::autolink(&$text, $target = '_blank', $nofollow = true)

     

  15. 一般 產生QR Code Utility::mk_qrcode($url)

     

  16. 一般 把字串換成群組(例如將「1,2,3」轉成「管理員<br>會員<br>訪客」) Utility::txt_to_group_name($groupid_txt = '', $default_txt = '', $syb = '<br>')

     

  17. 一般 載入 jquery.js Utility::get_jquery($ui = false, $mode = '', $theme = 'base')

     

  18. 少用 加入 jquery-migrate($mode="return"時傳回語法) Utility::add_migrate($mode = "")

     

  19. 少用 版本判斷($type = ['xoops', 'php']) Utility::get_version($type = 'xoops', $ver = '')

     

  20. 少用 改檔名 Utility::rename_win($oldfile, $newfile)

     

  21. 少用 解決 basename 抓不到中文檔名的問題 Utility::get_basename($filename)

     

  22. 少用 載入 bootstrap,目前僅後台用得到 Utility::get_bootstrap($mode = '')

     

  23. 少用 自動取得網址(輕鬆架的 mainfile.php用) Utility::get_xoops_url()

     

  24. 少用 自動取得實體位置(輕鬆架的 mainfile.php用) Utility::get_xoops_path()

     

  25. 少用 推文工具 Utility::push_url($enable = 1, $css = 'width:auto;margin:10px;float:right;')

     

  26. 少用 facebook的留言 Utility::facebook_comments($facebook_comments_width = 600, $modules = '', $page = '', $col_name = '', $col_sn = '')

     

  27. 少用 單選回復原始資料函數 Utility::chk($DBV = null, $NEED_V = '', $defaul = '', $return = "checked='checked'")

     

  28. 少用 複選回復原始資料函數 Utility::chk2($default_array = '', $NEED_V = '', $default = 0)

     

  29. 少用 取得所有群組陣列 Utility::get_all_groups()

     

  30. 少用 輸出為UTF8 Utility::to_utf8($buffer = '')

     

  31. 少用 判斷字串是否為utf8 Utility::is_utf8($str)

     

  32. 少用 自動轉換編碼 ($OS_or_Web 為 Web 時,代表將系統的編碼轉成和網站用編碼一致) Utility::auto_charset($str = '', $OS_or_Web = 'web')

     

  33. 少用 刪除整個目錄 Utility::rrmdir($path)

     

  34. 少用 將 $interface_menu 的內容做成json檔,放在 /uploads/menu_模組.txt Utility::make_menu_json($interface_menu = [], $moduleName = '')

     

  35. 少用 取得 tadtools 的偏好設定 Utility::TadToolsXoopsModuleConfig()

     

  36. 少用 偵測是否為行動裝置 Utility::mobile_device_detect($iphone = true, $ipad = true, $android = true, $opera = true, $blackberry = true, $palm = true, $windows = true, $mobileredirect = false, $desktopredirect = false)