徐嘉裕(Neil Hsu)的工作心得網誌!

之前寫過一篇【 用CSS做出來一個文字漸層+文字白框+文字陰影的LOGO區塊，CSS最終解法並符合無障礙 】的工作心得，但經過多次實際驗證，filter: drop-shadow方法雖然較為美觀，但在行動瀏覽或是平板，容易觸發 GPU 合成層，導致版面異常(畫面上下空白)，裝置發燙等耗電等問題，因此經改良後，改用CSS LOGO 描邊陰影字工法能維持與原本 filter: drop-shadow相同的效果，且手機平版不會異常，方法如下： 以下是使用-webkit-text-stroke/text-shadow做出來的文字效果，幾乎能90%還原PSD設計效果 文字的PHP常數增加data-storke設定 define('_THEME_LOGO_02','<div class="logo_01_box" aria-hidden="true" tabindex="-1" data-storke="桃園市" >桃園市</div><div class="logo_02_box" aria-hidden="true" tabindex="-1" data-storke="快樂" >快樂</div><div class="logo_03_box" aria-hidden="true" tabindex="-1" data-storke="國民小學" >國民小學</div>'); 注意： aria-hidden="true"：視覺文字不給讀報軟體讀。 - tabindex="-1"：避免視覺文字進入 TAB 流。 data-storke：提供 CSS content:attr(data-storke); 使用。 外層已有可讀 aria-label 或 sr-only，不要讓同一段校名被讀兩次。 CSS 核心寫法 #toplogobox{ position:relative; width:980p...

今天測試 XOOPS 2.7 的 profile 模組時，無意間發現後台欄位編輯有一個問題。 操作路徑：後台 → Profile 模組 → 欄位 → 編輯 只要修改任意一項後送出，就會出現錯誤： Errors field_name 為必填項 Incorrect column name '' MySQL 除錯訊息會看到類似這段： ALTER TABLE profile_profile ADD  varchar(255) NULL 一開始看起來很像資料表壞掉，因為 SQL 竟然要新增一個空白欄位名稱。但後來追程式才發現，真正原因不是資料表問題，而是表單送出時沒有把既有欄位的 id 傳回去。 XOOPS 2.7 的 modules/profile/admin/field.php 在儲存時會從 POST 讀取欄位 id： $fieldId = Request::getInt('id', 0, 'POST'); 如果 POST 沒有收到 id，系統就會誤判成「新增欄位」。但因為目前其實是在編輯既有欄位，表單中沒有 field_name 輸入框，最後就變成欄位名稱是空字串，進而產生： ADD  varchar(255) 修復方式 用文字編輯器打開：modules/profile/include/forms.php 找到 profile_getFieldForm() 裡建立表單的位置，大約在前段： $form = new XoopsThemeForm($title, 'form', $action, 'post', true); 在下方加入： if (!$field->isNew()) { $form->addElement(new XoopsFormHidden('id', $field->getVar('field_id'))); } 也就是讓所有「編輯既有欄位」的表單，都固定送出 hidden id。 修正後，送出欄位設定時，field.php 就能正常收到 POST id，不會再誤判成新增欄位，也不會產生空欄位名稱的 SQL。 修正後結果 經實測： - profile 欄位可正常編輯 - 欄位設定可正常儲存 - 不再出現 field_name ...

 XOOPS 2.7 全面升級到 Smarty 4 後，舊佈景或舊模組最容易炸掉的地方，就是樣板裡的 `<{php}>...<{/php}>`。 原因很單純：Smarty 4 已經不支援在樣板中直接執行 PHP。也就是說，舊寫法如果還把 PHP 邏輯塞在 `.tpl` 裡，升級後就會出現 unknown tag、白畫面或 SmartyCompilerException。 目前比較穩的解法，不是去 hack Smarty，也不是讓 Smarty 重新開放任意 PHP，而是把原本散落在樣板中的 PHP 程式碼收回 PHP 檔案，整理成 function，再用 `$tpl->registerPlugin()` 註冊成 Smarty 標籤，最後在樣板中用新標籤取代原本的 `<{php}>`。 簡單說： 舊寫法： .tpl 直接寫 <{php}> PHP CODE <{/php}> 新寫法： PHP 檔建立 function → registerPlugin 註冊成 Smarty function → .tpl 改用 <{php_channel}> 這樣效果接近原本 `<{php}>`，但執行入口變乾淨，也比較符合 Smarty 4 的規則。 修改方法如下說明： 一、建立相容函式檔 建議先建立一個 PHP 檔，專門收納原本樣板裡的流浪 PHP，例如： modules/模組ID/function/tpl_smarty_compat.php 示例： <?php //Smarty 4 樣板流浪 PHP 收容區 function register_smarty_compat($tpl=""){ if(empty($tpl) || !is_object($tpl)) return; if(!method_exists($tpl,'registerPlugin')) return; static $registered=array(); $tplid=function_exists('spl_object_id') ? spl_object_id($tpl) : spl_object_hash($tpl); if(!empty($regist...

話說時間過得真快，轉眼間又收到上半年度局端的伺服器「弱點管制表」通報，其中當然免不了那些PHP/Apache需要升級項目，但本次多了三個新弱點項目，做個紀錄日後就能SOP處理! 弱點名稱：備份檔案洩漏 弱點概述：It is possible to retrieve file backups from the remote web server. 弱點名稱：Web 伺服器的目錄/資料夾可被瀏覽 弱點概述：Some directories on the remote web server are browsable. 弱點名稱：Web 應用程式具有點擊劫持(ClickJacking)的弱點 弱點概述：The remote web server may fail to mitigate a class of web application vulnerabilities. 這三個弱點可以一次解決，只需要找到 HTTPS vhost，也就是 <IfModule mod_ssl.c> 裡的 <VirtualHost *:443>。 該檔案通常由 certbot 自動產生，檔案名稱多為：000-default-le-ssl.conf（通常位於 sites-available 資料夾中，並連結到 sites-enabled 啟用） sudo nano /etc/apache2/sites-available/000-default-le-ssl.conf 打開編輯 <IfModule mod_ssl.c> <VirtualHost *:443> 略........................ ServerAdmin webmaster@localhost DocumentRoot /var/www/html #防護設定加在DocumentRoot 後面 #這段解決Web 伺服器的目錄/資料夾可被瀏覽問題 <Directory /var/www/html> Options -Indexes AllowOverride All Require all granted </Directory> #這段解決備份檔案洩漏 <FilesMatch "(?i)(~$|\.bak$|\.old$|\.or...

由於原本Google提供的@import url('https://fonts.googleapis.com/css2?family=Noto+Sans+TC:wght@400&display=swap'); 會有阻塞渲染問題，導致 CSS 檔案載入變慢，瀏覽器必須先下載完 CSS，再解析到 @import，再去下載字體，這會增加網頁出現「空白字體（FOIT）」的時間。 基於效能優化，2026年建議改用CSS的@font-face自訂字體方法，也就是把字體放在自己的伺服器讓用戶載入網站字形，效能比@import方法要好，穩定性也更高，以下是完整建立@font-face方法說明。 1、先去fonts Google選擇需要的開源字體並下載 https://fonts.google.com/ 2、下載回來後解壓縮字形檔，因該是.ttf格式，建議改成 woff2格式會「比較穩」 .woff2 是現代瀏覽器標準壓縮過（小很多）Google Fonts 主力格式，以下網站可以更改字形副檔名格式 https://cloudconvert.com/ 點選Select File再選擇From my computer 選擇電腦中要改檔案的.ttf上傳後，選擇改為 woff2 Convert後等轉換完成，將.woff2 下載回來 3、在自己網站根目錄建一個fonts資料夾，然後吧字形檔貼入(例如cwTeXHei.woff2)，接者再fonts資料夾中建一個.htaccess 貼上以下防熱連設定，避免字形資源被人拿去白漂 RewriteEngine On # 只處理字型檔 RewriteCond %{REQUEST_URI} \.(woff2|woff|ttf|otf)$ [NC] # 空 referer 放行：直接開檔、本地測試、某些瀏覽器情境 RewriteCond expr "%{HTTP_REFERER} == ''" RewriteRule .* - [L] # localhost / 127.0.0.1 放行：只在目前主機就是本地端時成立 RewriteCond %{REQUEST_URI} \.(woff2|woff|ttf|otf)$ [NC] RewriteCond %{HTTP_HOST} ^(localhos...

由於無障礙AA中規定對於A元素，或是iframe都需要有title語意說明，若是LINK外連還需要加上另開新視窗說明，如果用CK編輯器複製貼上，來源端就帶有連結但USER又沒設title就會被列為缺失，假使只是用於小型的說明用途欄位，用以下的CK設定參數就可以解決了! CKEDITOR.replace(" t extarea的id ", { height: 200, //高度 //toolbar參數，簡單的basicstyles及paragraph兩個插件(可自行增加) toolbar: [ { name: 'basicstyles', items: [ 'Bold', 'Italic', '-', 'RemoveFormat' ] }, { name: 'paragraph', items: [ 'NumberedList', 'BulletedList' ] } ], removePlugins: 'link,iframe,flash,forms', forcePasteAsPlainText: true }); 重點說明 removePlugins: 'link,iframe,flash,forms', 直接禁止：link，iframe，flash，forms類型的物件存在編輯器 forcePasteAsPlainText: true 貼上時，只保留純文字，不要任何格式 例如複製這一段有帶超連結的內容 貼到CK編輯框後，自動變成純文字格式，USER貼文也就不會有無障礙缺失的問題 這方法適合只需要簡單文字的編輯框，像是簡易討論區或是留言板，以及公開資料說明等，再必須符合無障礙AA規範下，用這方法能解決。 以上工作心得撰寫，有需要的朋友參考看看💁💁 工作心得撰寫： 徐嘉裕 Neil hsu