自訂內容

建立自訂的 CSS 樣式表、JavaScript 手槁、全域警告訊息、以及能以 Markdown 格式撰寫公司最新消息的新頁面。

Kevin Papst
提供者
Kevin Papst

A Kimai plugin which allows adding custom content for:

  • Stylesheet (embedded in all pages)
  • Javascript (embedded in all pages, except security screens)
  • A global warning message, shown to every logged-in user
  • An entire new page to display (markdown formatted) information for your users

Alternative

If you only want to add some custom CSS stylesheets, you can have a look at this free item instead: 自訂 CSS 樣式表

Storage

This bundle stores contents in the directory var/data/custom-content-bundle/.

Make sure the data directory is writable by your webserver and included in your backups.

Changelog

## Version 2.3.1

Compatibility: requires minimum Kimai 2.5.0

- Changed: import Route attribute from correct namespace
- Changed: use bundle identifier to load routes

## Version 2.3.0

Compatibility: requires minimum Kimai 2.5.0

- Changed: moved some translations to core, allowing more languages

## Version 2.2.0

Compatibility: requires minimum Kimai 2.1.0

- Fixed: route mapping type changed to attribute

## Version 2.1.1

Compatibility: requires minimum Kimai 2.0

- Added: explicit ID and class to target markdown news content via Javascript

## Version 2.1.0

Compatibility: requires minimum Kimai 2.0

- Added: new permissions `js_custom_content`, `css_custom_content`, `alert_custom_content`, `news_custom_content` for separate content sections
- Added: better tabs

## Version 2.0.3

Compatibility: requires minimum Kimai 2.0

- Fixed: do not escape HTML in javascript content

## Version 2.0.2

Compatibility: requires minimum Kimai 2.0

- Added: improved validation rules
- Fixed: show submitted tab again

## Version 2.0.1

Compatibility: requires minimum Kimai 2.0

- Fixed: compatibility with Kimai 2.0 (new Configuration access API)

## Version 2.0

Compatibility: requires minimum Kimai 2.0

- Fixed: compatibility with Kimai 2.0

## Version 1.2

Compatibility: requires minimum Kimai 1.17

- Added: automatically import settings from CustomCSS bundle (when admin page is opened first)
- Added: Translations for tabs (added german)

## Version 1.1

Compatibility: requires minimum Kimai 1.17

- Fixed: saving failed
- Code cleanup

## Version 1.0

Compatibility: requires minimum Kimai 1.17

- Added support for: Custom CSS
- Added support for: Custom Javascript
- Added support for: Custom warning message (alert)
- Added support for: Custom page with title (name of menu) and content

安裝

複製檔案

Extract the ZIP file and upload the included directory and all files to your Kimai installation to the new directory:

var/plugins/CustomContentBundle/

The file structure needs to look like this afterwards:

var/plugins/
├── CustomContentBundle
│   ├── CustomContentBundle.php
|   └ ... more files and directories follow here ...

清除快取

After uploading the files, Kimai needs to know about the new plugin. It will be found once the cache was re-built. Call these commands from the Kimai directory:

How to reload Kimai cache

bin/console kimai:reload --env=prod

It is not advised, but in case the above command fails you could try:

rm -r var/cache/prod/*

You might have to set file permissions afterwards:

Adjust file permission

You have to allow PHP (your webserver process) to write to var/ and it subdirectories.

Here is an example for Debian/Ubuntu (to be executed inside the Kimai directory):

chown -R :www-data .
chmod -R g+r .
chmod -R g+rw var/

更新

Updating the plugin works exactly like the installation:

  • Delete the directory var/plugins/CustomContentBundle/
  • Execute all installation steps again:
    • 複製檔案
    • 清除快取

相容性

下表比較了外掛程式與所需的最低 Kimai 版本。

套件版本 最低 Kimai 版本
2.3.0 - 2.3.1 2.5.0
2.2.0 2.1.0
2.1.0 - 2.1.1 2.0
2.0.1 2.0
1.2.1 1.17

體驗版本

如要測試此外掛程式,可前往體驗版網頁 demo.kimai.org:

使用者名稱: susan_super
密碼: kitten

在此處找到更多測試帳號.

使用截圖

Screenshot
這則警告訊息會顯示在已登入使用者的所有頁面上
Screenshot
自訂的 Javascript 手稿會在已登入的使用者的所有頁面上執行
Screenshot
您能以 Markdown 格式撰寫最新消息與自訂標題
Screenshot
這個最新消息頁面在使用者選單內有對應鏈結,且內容可為您以 Markdown 格式撰寫的訊息

常見問題

這些常見問題由本外掛程式的開發者提供。

You can buy the plugin via the Marketplaces 'Lemon Squeezy' or 'Gumroad' and pay with Credit Card or PayPal. Both offer instant access to the purchases.

Support-questions, bug-reports and feature-requests will be answered in this Github repository

提供者

Kevin Papst

Building Kimai since 2009

如果您有任何問題,請透過以下聯絡資訊直接與此開發者聯繫。
Top