1. XoopsModules\Tadtools\Utility 工具集

use XoopsModules\Tadtools\Utility;

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

常用 XOOPS表單安全檢查（配合表單token 使用）
```
Utility::xoops_security_check()
```
常用將陣列列出（除錯用，取代die(var_dump($arr))）
```
Utility::dd($array = [])
```
常用建立目錄
```
Utility::mk_dir($dir = '')
```

常用自訂錯誤訊息

Utility::web_error($sql, $file = '', $line = '', $force = false)

常用細部權限判斷

Utility::power_chk($perm_name = '', $perm_itemid = '', $module_id = '', $trueifadmin = true)

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

常用取得分頁工具

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);

常用取得模組工具列（$force為true時，$interface_menu 無論有無內容，都會呈現工具列）
```
Utility::toolbar_bootstrap($interface_menu = [], $force = false)
```
一般刪除目錄
```
Utility::delete_directory($dirname)
```

一般拷貝目錄

Utility::full_copy($source = '', $target = '')

一般路徑導覽，需搭配 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;
}

一般設定頁面 meta 給FB、Line 等網站使用

Utility::setup_meta($title = '', $content = '', $image = '')

一般產生HTML5頁面語法

Utility::html5($content = '', $ui = false, $bootstrap = true, $bootstrap_version = 3, $use_jquery = true, $container = 'container', $title = 'XOOPS', $head_code = '')

一般將文字中的網址轉為連結

Utility::autolink(&$text, $target = '_blank', $nofollow = true)

一般產生QR Code
```
Utility::mk_qrcode($url)
```
一般把字串換成群組（例如將「1,2,3」轉成「管理員<br>會員<br>訪客」）
```
Utility::txt_to_group_name($groupid_txt = '', $default_txt = '', $syb = '<br>')
```

一般載入 jquery.js

Utility::get_jquery($ui = false, $mode = '', $theme = 'base')

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

少用版本判斷（$type = ['xoops', 'php']）

Utility::get_version($type = 'xoops', $ver = '')

少用改檔名
```
Utility::rename_win($oldfile, $newfile)
```
少用解決 basename 抓不到中文檔名的問題
```
Utility::get_basename($filename)
```
少用載入 bootstrap，目前僅後台用得到
```
Utility::get_bootstrap($mode = '')
```
少用自動取得網址（輕鬆架的 mainfile.php用）
```
Utility::get_xoops_url()
```
少用自動取得實體位置（輕鬆架的 mainfile.php用）
```
Utility::get_xoops_path()
```

少用推文工具

Utility::push_url($enable = 1, $css = 'width:auto;margin:10px;float:right;')

少用 facebook的留言

Utility::facebook_comments($facebook_comments_width = 600, $modules = '', $page = '', $col_name = '', $col_sn = '')

少用單選回復原始資料函數

Utility::chk($DBV = null, $NEED_V = '', $defaul = '', $return = "checked='checked'")

少用複選回復原始資料函數

Utility::chk2($default_array = '', $NEED_V = '', $default = 0)

少用取得所有群組陣列
```
Utility::get_all_groups()
```
少用輸出為UTF8
```
Utility::to_utf8($buffer = '')
```
少用判斷字串是否為utf8
```
Utility::is_utf8($str)
```
少用自動轉換編碼（$OS_or_Web 為 Web 時，代表將系統的編碼轉成和網站用編碼一致）
```
Utility::auto_charset($str = '', $OS_or_Web = 'web')
```
少用刪除整個目錄
```
Utility::rrmdir($path)
```
少用將 $interface_menu 的內容做成json檔，放在 /uploads/menu_模組.txt
```
Utility::make_menu_json($interface_menu = [], $moduleName = '')
```
少用取得 tadtools 的偏好設定
```
Utility::TadToolsXoopsModuleConfig()
```

少用偵測是否為行動裝置

Utility::mobile_device_detect($iphone = true, $ipad = true, $android = true, $opera = true, $blackberry = true, $palm = true, $windows = true, $mobileredirect = false, $desktopredirect = false)