============================================

Asteroid 報名系統 - Readme

============================================

Version 1.9

這是透過網路及 MySQL 資料庫，提供報名者透過網路報名以及提供使用者管理網路報名資料的 PHP-scripts。


========================
版權 Copyright
========================

Copyright (C) 2012-2013 Freeman Li and Karen Liao


========================
許可 License
========================

本程式是自由軟體，您可以遵照自由軟體基金會 (Free Software Foundation) 出版的 GNU 通用公共許可證條款 (GNU General Public License) 第二版來修改和重新發佈這一程式，或者自由選擇使用任何更新的版本。

發佈這一程式的目的是希望它有用，但沒有任何擔保。甚至沒有適合特定目的而隱含的擔保。更詳細的情況請參閱 GNU 通用公共許可證。

您應該已經和程式一起收到一份 GNU 通用公共許可證的副本。如果還沒有請見下列網址：
http://www.gnu.org/licenses/

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see
http://www.gnu.org/licenses/.


========================
系統需求 Requirements
========================

* PHP 5.3 or later
* MySQL 5.0 or later
* SMTP account
* a web-browser (doh!)

本版已測試過相容於以下的系統環境

- Windows 2003 + IIS + php 5.3.x (5.4.x) + MySQL 5.1.X (5.5.x)
- Debian + Apache2 + MySQL 5.1.66 + php 5.3.3-7


========================
下載 Download
========================

您可以透過下列版本歷程中的下載網址下載本報名系統。
You can get the newest version at http://ticket-app.tam.gov.tw/activity/uploads/asteroid_1.8.zip.


========================
安裝 Installation
========================

1. 請先確認上述系統需求是否都完備，並已安裝完成。
2. 下載本系統程式，下載完後，請解開壓縮檔。
3. 請使用 phpmyadmin 或其他軟體在 MySQL 建立一個 資料庫(Schema) 它的預設語言為 utf8 (或是utf8_general_ci) 。
4. 請使用 phpmyadmin 或其他軟體建立一個可以使用這個 資料庫(Schema) 的帳號與密碼，本系統不會自行建立。
5. 請在 SMTP 郵件伺服主機中建立（或使用已有的）一個可供本系統寄發郵件的帳號與密碼，本系統不會自行建立。
6. 請修改 config 資料夾下的 config.bak.php 檔案，依其內說明完成修改後，將其檔案名稱改為 config.ini.php 。
7. 如不修改 install/admin.php 其中的內容，預設的管理員帳號為 Admin，密碼為 111111 。
8. 然後將整個資料夾上傳至 web server。
9. 透過瀏覽器執行 install/creater.php，若執行順利表示系統已經完成建置，請注意這個程式會摧毀 資料庫(Schema) 下的資料表。
10. 刪除掉 install 資料夾及其下所有檔案。
11.以系統管理者的密碼登入後儘速設定單位的組室資料並修改管理者的密碼，建議是建立一個新的管理者帳號，刪除掉原本的 Admin 帳號。
12.修改 uploads 資料夾的屬性，使一般網頁瀏覽者具有修改及寫入的權限。
13.測試新增活動群組後再新增活動，如一切順利，Enjoy!



========================
版本歷程 ChangeLog
========================
Version 1.9
- 新增及修改活動學員填寫「檢查正則表示」欄位時(Rule 5 如[通關密碼])時進行重複性檢查。
- 上述設計的原則是一起報名者可共用一個正則表示(優先檢查)，並且同一種類的活動只能使用一次。
- 新增及修改 tinyupload 伺服器端的程式，外掛於 tinymce 並相容於 Windows 的伺服器系統，使活動說明及電子郵件通知的內容可以文圖並茂。
- 修正如果不使用 tinymce 時的錯誤訊息。
- 新增報名人員的簡易統計，包含簡單的月報，日報，及各時段報名人數統計，方便給研考人員統計用。
- 新增輸出所有報名人員報名紀錄。
- 修正 logact 的順序錯置。
- 修正部分程式內容，使報名者在正常操作下不會出現 PHP Notice 及 Warning 的訊息。
- 此版開始相容於IPv6 的環境。
-


Version 1.8a 下載
- 修正相容性，相容於具有 mysqli 卻不使用MySQL Native Drive (mysqlnd) 的 php 系統。
- 修正部分系統使用 str_getcsv 函式處理 UTF8 碼時的判斷錯誤。
- 修正安裝程式的相容性判斷語法。
- 修正個別活動上傳附件檔案的顯示錯誤。
- 修正匯出 Excel 檔案時遇到 Null 值的錯誤。
- 允許修改個別活動所屬的活動種類。
- 增加匯出學員的資料的檔案類型。
- 2013.3.27 釋出



Version 1.7a 下載
- 修改活動報名者列表，除了報名者姓名欄位不可排序外，其餘欄位均可排序。
- 修改個人資料保護專區的顯示問題。
- 修改後台的審核管理，加入tablesorter 方便排序管理。
- 修改新增及修改活動時javascript的檢查機制。
- 修正電子郵件的程式碼，允許使用SSL等傳輸協定。
- 修改安裝程式，加入正確的環境檢查條件，以及測試系統環境是否可以安裝及正確執行。
- 修正些許小錯誤。
- 此版（含以前）不相容於具有 mysqli 卻不使用 MySQL Native Drive (mysqlnd) 的 php 系統。
- 2013.3.17 釋出


Version 1.6
- 修正後台列表因為活動名稱過長造成顯示錯誤。
- 修正上傳檔案副檔名為大寫時無法上傳。
- 修正學員年齡人數計算的錯誤。
- 修正許多小錯誤。
- 2013.3.6 釋出。

Version 1.5
- 修正Client端的程式，改為採用jquery, jquery ui 以及 Timepicker的 API。
- 加入TableKit將輸出的表格進行排序。
- 修正許多小錯誤。
- 2013.2.9 正式上線服務。

Version 1.0
- 2013.1.13完成系統的結構。


========================
本系統所使用的外掛 Plugins
========================

1. PHPExcel from http://www.codeplex.com/PHPExcel
2. TableKit from http://www.millstream.com.au/view/code/tablekit
3. TinyMCE - Javascript WYSIWYG Editor from http://www.tinymce.com/
4. PHPMailer - PHP email class from https://code.google.com/a/apache-extras.org/p/phpmailer/
5. jQuery
6. jQueryUI (with datepicker and slider wigits)
7. Timepicker
8. tablesorter from http://tablesorter.com/docs/

========================
支援 Support
========================

您可以將所遇到的問題以及錯誤寄信給我，但因我時間有限，沒有義務一定得回覆或是必須修正某個錯誤。
Please, don't send me emails with question like "How do I compile PHP with MySQL-support". I just don't have the time to be your free help desk.


聯繫作者


僅將此系統獻給我天上的父親，
感謝詹佩菁、「從鈴開始傳藝推廣協會」等協助測試。
還有感謝我大學時的電腦老師崔大山，雖然我在他叫我學習資料庫時，就決定先溜了，沒想到繞了一圈，發現我大部分的時間還是在處理資料庫。

Enjoy!
========================

---