A WordPress plugin providing a shortcode to embed a list of commits of a project.
lang | ||
.gitignore | ||
linuxfoo-gitlab.php | ||
README.md | ||
styles.css |
linuxfoo-gitlab
Summary
Embed a list of the most recent commits to a Gitlab project. Information is retrieved from a specified Gitlab instance's public REST API.
Shortcode gitlab-list-commits
Example
Add the following shortcode to your post for a list of at most 5 commits to that project that were made since at most 3 months ago:
[gitlab-list-commits url="https://tk-sls.de/gitlab" project_id=42 since="3 months" max=5]
Attributes
url="STRING"
: Mandatory (example:https://tk-sls.de/gitlab
).project_id=NUM
: Mandatory;NUM
: Positive Integer, valid project ID in Gitlab specified byurl
(example:42
).since="NUM UNIT"
: Optional;NUM
: Positive integer;UNIT
:days
,months
,years
; exclude commits older than specified time interval (example:3 months
).max=NUM
: Optional;NUM
: Positive integer; list not more thanNUM
commits (example:5
).ref_name=STRING
: List only commit from branch or reference nameSTRING
(examples:main
,v1.1
).default_branch
: If set, list only commits from the project's default branch.
Author and License
- Copyleft 2021 Tilman Kranz <t.kranz@tk-sls.de>
- License: MIT License https://opensource.org/licenses/MIT