Skip to content
ListPower 讓你可以針對特定主題,與社群一起蒐集整理資料,感受到清單力量的強大!
Branch: master
Clone or download
Latest commit 05b8285 Apr 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Modules/SocialAuth first commit on github Mar 27, 2019
app sort data Apr 17, 2019
bootstrap first commit on github Mar 27, 2019
config support image upload drivers: local_file & cloudinary Apr 3, 2019
database add entity status Apr 16, 2019
docs
e2e-tests fix tests Apr 16, 2019
public show photos in the image gallery Apr 17, 2019
resources gallery ux Apr 23, 2019
routes add ADMIN_ACCOUNT_EMAIL Apr 2, 2019
storage first commit on github Mar 27, 2019
tests first commit on github Mar 27, 2019
.editorconfig first commit on github Mar 27, 2019
.env.example readme: map Apr 2, 2019
.gitattributes first commit on github Mar 27, 2019
.gitignore first commit on github Mar 27, 2019
LICENSE.txt Create LICENSE.txt Apr 3, 2019
artisan first commit on github Mar 27, 2019
composer.json support image upload drivers: local_file & cloudinary Apr 3, 2019
composer.lock support image upload drivers: local_file & cloudinary Apr 3, 2019
package-lock.json upgrade webpack-dev-server Apr 1, 2019
package.json
phpunit.xml first commit on github Mar 27, 2019
readme.md readme Apr 3, 2019
server.php first commit on github Mar 27, 2019
webpack.mix.js first commit on github Mar 27, 2019

readme.md

ListPower 清單力量

ListPower 讓你可以針對特定主題,與社群一起蒐集整理資料,感受到清單力量的強大!

請參考基於 ListPower 開發的幾個線上網站:

另外也請參考 ListPower 的發展背景故事:

清單力量 OPEN SOURCE:跟網友一起蒐集清單資料的系統

功能

目前的「核心系統」有六大功能:

  • 新增
  • 編修
  • 評分
  • 留言
  • 照片
  • 標籤

六項功能都是支援社群參與,功能與介面設計,都是能讓用戶們一起加入貢獻。

系統需求

ListPower 是基於 Laravel 5.8 版本開發,系統需要能跑 Laravel 5.8 以上的版本。

安裝

ListPower 基本上就是一個普通的 Laravel 應用程式。

請 git clone 或是直接下載這份程式碼,之後按照一般流程架設即可。

設定

1. Facebook 帳號登入

預設使用 Facebook 帳號登入,請在 .env 中設定以下參數:

  • FACEBOOK_CLIENT_ID
  • FACEBOOK_CLIENT_SECRET
  • FACEBOOK_REDIRECT

2. 設定管理員

請在 .env 中設定參數:ADMIN_ACCOUNT_EMAIL

3. 建立新清單

透過網頁面板新增:

  • 點選上方「建立新清單」
  • 點選「手動設定欄位」

透過網頁面板匯入:

  • 點選上方「建立新清單」
  • 點選「匯入 CSV 檔」

4. 啟用 Google 地圖

清單如果有欄位設定為「地址」類型,就會啟用地圖功能。

請在 Google Cloud Platform 開啟以下 API 權限:

  • Maps Embed API
  • Google Maps JavaScript API
  • Google Maps Geocoding API

之後在 .env 中設定以下參數:

  • GOOGLE_MAP_KEY:這是用來在瀏覽器呼叫 Google 顯示地圖的 key,會在瀏覽器被看到,因此請設定好「HTTP 參照網址」
  • GOOGLE_MAP_KEY_UNRESTRICTED:這是在伺服器端呼叫 Google 將地址轉成經緯度的 key,不會在瀏覽器被看到,請設定好「IP 位址」或是以「無」設定

Roadmap

  • 新增與編修權限設定功能

    • 目前清單資料是自由貢獻
    • 做成可設定「全開放」、「需審核」、「不可編輯」
  • 模板主題功能

    • 開發 themes 功能,目前的主題僅是「listbox」平台主題
    • 讓特定主題的站能有自己的品牌主題
    • 開發 theme helper layer(可以是一堆 function 或是 Facade),方便創造主題時能專注在 html/css
  • 用戶與清單權限功能

    • 每張清單各自有一或多個管理員
    • 開發管理面板,讓管理員能管理資料
  • 完成地圖模組

    • 確定抓取座標的時間點
    • 設計座標不準確時,人為介入修正的機制
    • 可切換 map 來源(Google, MapBox, OpenStreetMap, ...etc)
  • 支援系統更新的檔案架構,open source 核心升級時,各專案要能無痛升級,包含:

    • 開發了各自主題的專案
    • 進行過功能客製化的專案
  • 更多登入方式

    • Google, Twitter, Native Login, etc...

Contributing

謝謝您考慮貢獻開發到本專案。

目前專案處於早期核心設計階段,除了明顯的錯誤修正、功能加強、小範圍的優化歡迎直接送 PR 之外,請不要直接寫新功能的開發 PR。

請跟我一起討論、設計之後,在確保早期核心設計清楚、簡單、一致的情況下,再進行開發。我們可以先一起討論設計下 spec,謝謝您。

License

Licensed under the GNU General Public License Version 3.0 or later.

You can’t perform that action at this time.