Content
View differences
Updated by Dominic Bräunlein 2 days ago
In OpenProject:
* There are two new Macros in the work package toolbar
* "New wiki page" and "Add wiki page"
* When user clicks on "New wiki page" the _new wiki page_ dialog will appear:
* The user will be invited to enter a title for the Wiki.
* They will also be able to select the parent to which this Wiki will belong.
* The newly-created wiki page will appear in the Wiki tab since it is also automatically linked with the work package.
* The corresponding link will appear in-line. Clicking on this link will take the user to the newly-created page on XWiki.
* When user clicks on "Add wiki page" the _add wiki page_ dialog will appear:
* The user will be invited to select a Wiki page.
* All available wiki pages are shown as tree view with meta information and a search
* The selected wiki page will appear in the Wiki tab since it is also automatically linked with the work package.
* The corresponding link will appear in-line. Clicking on this link will take the user to the selected page on XWiki.
### Implementation
* Prerequisites:
* (assumed to be present) OpenProject's rich text editor has a generic slash-command UX pattern implemented, generically allowing "providers" to register commands (Currently not yet available. Implementation outside the scope of this here. Will be done by OpenProject independently)
* (assumed to be present) XWiki API for listing spaces
* (assumed to be present) XWiki API for listing pages, optionally filtering by space
* (Implementation needed in XWiki) XWiki API for pages that allow for creating a link to a OpenProject work package
* (Implementation needed in XWiki and OpenProject) Bi-directional OAuth setup on administrator level. Defined in ##55601.
* Editor macro "Create new wiki page"
* Effort:
* UI to guide the user to grant OpenProject access to XWiki via OAuth unless a valid access token is already present.
* Implement macro for **creating** wiki pages
* Modal window with a form for creating a wiki page
* Inputs
* Select target parent
* Text field for page title
* On form submit
* create page by sending a POST request to XWiki to create the page
* send POST request to XWiki to create the link between work package and freshly created wiki page
* Show optional link "Edit page in XWiki"
* On modal close
* send POST request to XWiki to create the link
* update the current work package "Wiki" tab to show new link
* Insert OpenProject rich text editor macro for showing a link to the wiki page.
### Visuals
<br>
**Added macros to add existing or add existing wiki page**
<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/918299/content"></div></figure>
<br>
**User can select** _**Create new wiki page**_ **to create and link a wiki page in-line:**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/107263/content">
**The New wiki page dialog lets users type a name and select a parent:**
(Visuals needs update)
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/107264/content">
**The link also appears in the Wikis tab in the right-hand split screen:**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/107265/content">
###
* There are two new Macros in the work package toolbar
* "New wiki page" and "Add wiki page"
* When user clicks on "New wiki page" the _new wiki page_ dialog will appear:
* The user will be invited to enter a title for the Wiki.
* They will also be able to select the parent to which this Wiki will belong.
* The newly-created wiki page will appear in the Wiki tab since it is also automatically linked with the work package.
* The corresponding link will appear in-line. Clicking on this link will take the user to the newly-created page on XWiki.
* When user clicks on "Add wiki page" the _add wiki page_ dialog will appear:
* The user will be invited to select a Wiki page.
* All available wiki pages are shown as tree view with meta information and a search
* The selected wiki page will appear in the Wiki tab since it is also automatically linked with the work package.
* The corresponding link will appear in-line. Clicking on this link will take the user to the selected page on XWiki.
### Implementation
* Prerequisites:
* (assumed to be present) OpenProject's rich text editor has a generic slash-command UX pattern implemented, generically allowing "providers" to register commands (Currently not yet available. Implementation outside the scope of this here. Will be done by OpenProject independently)
* (assumed to be present) XWiki API for listing spaces
* (assumed to be present) XWiki API for listing pages, optionally filtering by space
* (Implementation needed in XWiki) XWiki API for pages that allow for creating a link to a OpenProject work package
* (Implementation needed in XWiki and OpenProject) Bi-directional OAuth setup on administrator level. Defined in ##55601.
* Editor macro "Create new wiki page"
* Effort:
* UI to guide the user to grant OpenProject access to XWiki via OAuth unless a valid access token is already present.
* Implement macro for **creating** wiki pages
* Modal window with a form for creating a wiki page
* Inputs
* Select target parent
* Text field for page title
* On form submit
* create page by sending a POST request to XWiki to create the page
* send POST request to XWiki to create the link between work package and freshly created wiki page
* Show optional link "Edit page in XWiki"
* On modal close
* send POST request to XWiki to create the link
* update the current work package "Wiki" tab to show new link
* Insert OpenProject rich text editor macro for showing a link to the wiki page.
### Visuals
<br>
**Added macros to add existing or add existing wiki page**
<figure class="image op-uc-figure"><div class="op-uc-figure--content"><img class="op-uc-image" src="/api/v3/attachments/918299/content"></div></figure>
<br>
**User can select** _**Create new wiki page**_ **to create and link a wiki page in-line:**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/107263/content">
**The New wiki page dialog lets users type a name and select a parent:**
(Visuals needs update)
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/107264/content">
**The link also appears in the Wikis tab in the right-hand split screen:**
<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/107265/content">
###