{"id":19170701,"url":"https://github.com/algorys/redissue","last_synced_at":"2025-05-07T15:52:48.547Z","repository":{"id":36006273,"uuid":"40299491","full_name":"algorys/redissue","owner":"algorys","description":"Dokuwiki plugin to display Redmine issues","archived":false,"fork":false,"pushed_at":"2024-06-01T14:15:52.000Z","size":208,"stargazers_count":5,"open_issues_count":5,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-31T11:35:41.060Z","etag":null,"topics":["bootstrap-theme","dokuwiki","dokuwiki-plugin","redmine"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/algorys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-06T10:39:29.000Z","updated_at":"2018-11-17T22:15:20.000Z","dependencies_parsed_at":"2022-08-17T22:00:31.390Z","dependency_job_id":null,"html_url":"https://github.com/algorys/redissue","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algorys%2Fredissue","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algorys%2Fredissue/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algorys%2Fredissue/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/algorys%2Fredissue/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/algorys","download_url":"https://codeload.github.com/algorys/redissue/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249833631,"owners_count":21331842,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap-theme","dokuwiki","dokuwiki-plugin","redmine"],"created_at":"2024-11-09T09:54:53.530Z","updated_at":"2025-04-20T00:30:48.395Z","avatar_url":"https://github.com/algorys.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Plugin Redissue\n\nPlugin Dokuwiki display issues of Redmine and keep the rights of Redmine too. Redissue have the following features:\n\n* Name of issue\n* Number, percentage, author of issue\n* Make a link to the choosen issue in Redmine and the related project.\n* Display more or less information depending on your rights.\n* Compatible with [Bootstrap](http://getbootstrap.com/) (like with [Dokuwiki Temaplte Bootstrap3](https://github.com/LotarProject/dokuwiki-template-bootstrap3/)).\n\n## Requirements\n\nRedissue needs [Php-Redmine-API](https://github.com/kbsali/php-redmine-api) to work. Download it inside the ROOT of your redissue's folder or inside ``/usr/share/php`` folder. The last place is better if you use [Redproject](https://www.dokuwiki.org/plugin:redissue) too, as you've just to install API once time.\n\nIn any case, Php-Redmine-API must be located inside a `vendor` folder !\n\n```bash\nmkdir vendor\ncd vendor\ngit clone https://github.com/kbsali/php-redmine-api.git\ncd php-redmine-api\n# Go to last version. Use \"git describe --abbrev=0\" to see last tag.\ngit checkout v1.5.x\n```\n\nDon't forget to install the **requirements** of PhP-Redmine-API :\n\n```bash\nsudo apt-get install php5-curl php5-common\n```\n\n## Install\n\nDownload Redissue plugin into your ``${dokuwiki_root}/lib/plugins`` folder and restart dokuwiki.\n\n## Configuration\n\nYou can configure Redissue in the Config Manager of DokuWiki:\n\n* redissue.url: Put your Redmine's url server, without a slash ending. Example : ``http://myredmine.com``. This setting can be override by _server_ option.\n* redissue.img: Maybe you have a custom icon for your Redmine installation. You can put image'url here. Example : ``http://www.example.com/image.png``\n* redissue.theme: If you have the theme [Bootstrap 3](https://www.dokuwiki.org/template:bootstrap3) installed (or another supported _Bootstrap_ theme), you can set redissue to bootstrap. Otherwise, simply choose theme Dokuwiki.\n* redissue.API: Set your Redmine API's key, preference Administrator key. This setting can be override by _server_ option.\n* redissue.view: Choose the view you want to display. This will depend on the wiki user's access rights in Redmine.\n  * Impersonate: select this if your wiki's users have the same UID as Redmine's users. e.g. : LDAP authentication. Redissue then will manage rights based on private or public projects.\n  * Userview: doesn't manage access rights and display issue even if it's in private project.\n\nSome advanced settings are also available below.\n\n## Syntax\n\n### Single issue syntax:\n\n```php\n\u003credissue id=\"#number_issue\" text=\"text_if_no_rights_or_API\" /\u003e\n```\n\n* id: id of the wanted issue.\n* text: displays a text other than the default if the user does not have the rights or the issue does not exist\n\n### Multiple issue syntax\n\nIf you want to get all issues of a specific project and/or a specific tracker, it's also possible. You've **2** other options:\n\n* project: the **right** identifier of the project (Available in the settings of redmine project): project=\"myproject\"\n* tracker: the identifier number of your tracker. (You can found this number if you look at the number in the link of a tracker): tracker=\"3\"\n\nIn this case, the twice parameter **must be set** but one can be empty. E.g: if you want to have all issues of a project for all trackers, you can leave tracker empty\n\n* limit: set the limit of issues displayed. Default is 25.\n\n**Examples:**\n\n```php\n// Display the first 25 issues with tracker 1 for project \"myproject\"\n\u003credissue project=\"myproject\" tracker=\"1\" /\u003e\n// Display the first 25 issues for project \"myproject\"\n\u003credissue project=\"myproject\" tracker=\"\" /\u003e\n// Display the first 50 issues with tracker 4 for all projects (if you have rights)\n\u003credissue project=\"\" tracker=\"4\" limit=\"50\" /\u003e\n```\n\nYou can also sort the issues according to your interests.\n\n* sort: choose how issues will be displayed. by default they are displayed by **id** number, from the most recent to the oldest (descending).\n\nYou can choose to sort by : id, subject, project, tracker, ...\n\n**Examples:**\n\n```php\n// Sort issue by ascending \"id\", for project \"myproject\" and tracker \"1\"\n\u003credissue project=\"myproject\" tracker=\"1\" sort=\"id\" /\u003e\n// Sort issue by \"subject\" for project \"myproject\" and all trackers\n\u003credissue project=\"myproject\" tracker=\"\" sort=\"subject\"/\u003e\n```\n\n### Manage Multiple Servers\n\n* server: In case you have multiple server, you can override the server url and the API key defined in the Redissue **settings**. You must define these in a json file called `server.json` (already available in plugin folder). This file must be at root of redissue folder.\n\nExample of _server.json_ file:\n\n```json\n{\n    \"first\": {\n        \"url\": \"http://myfirst.redmine.com\",\n        \"api_token\": \"abcdefghijklmnopqrstuvwxyz0123456789\"\n    },\n    \"second\": {\n        \"url\": \"http://mysecond.redmine.com\",\n        \"api_token\": \"zyxwvutsrqponmlkjihgfedcba9876543210\"\n    }\n}\n```\n\nThen simply add your server with: `server=\"first\"` in redissue syntax.\n\n**Note:** If server url or key in json file is wrong or if you put a wrong name in \"server\" parameter(e.g: call _flirt_ instead _first_), redissue take the one who is set in dokuwiki settings. If **url** or **api_token** are wrong everywhere, an error message will be displayed instead of redissue.\n\n### Other options\n\n* title: you can override issue title if it's too long or for other reasons with: `title=\"my new title\"`.\n* short: (**dokuwiki theme only**, bootstrap not needed this functionnality). If you've dokuwiki theme, you can hide additional information with short: `short=\"1\"`.\n\nThen, Redissue will display all the issue of this tracker for this specific project. If \"project\" or \"tracker\" identifiers are bad, Redissue display only issue with Id you have defined in \"id\" option.\n\n## Preview\n\nHere is a preview of redissue:\n\n* Dokuwiki theme\n\n![Dokuwiki Theme](images/redissue_dokuwiki.png)\n\n* With a bootstrap Theme\n\n![Bootstrap Theme](images/redissue_bootstrap.png)\n\nFor further information, see also [Redissue on dokuwiki.org](https://www.dokuwiki.org/plugin:redissue)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgorys%2Fredissue","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falgorys%2Fredissue","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falgorys%2Fredissue/lists"}