In OpenProject:

* There are two new Begin of the insertionentriesEnd of the insertion Begin of the deletion MacrosEnd of the deletion in the Begin of the insertion"+ Insert" dropdown of theEnd of the insertion work package toolbar

* "New wiki page" and Begin of the insertion"ExistingEnd of the insertion Begin of the deletion "AddEnd of the deletion wiki page"

* When user clicks on "New wiki page" the _new wiki page_ dialog will appear:

* The user will be invited to enter Begin of the deletion a title forEnd of the deletion the Begin of the insertionprovider firstEnd of the insertion Begin of the deletion Wiki.End of the deletion

* Begin of the insertionThenEnd of the insertion Begin of the deletion They will also be able to selectEnd of the deletion the Begin of the insertiontitle for the Wiki and theEnd of the insertion parent to which this Wiki will belong.

* The newly-created wiki page will appear in the Begin of the insertionwork package description in-line, as well as in theEnd of the insertion Wiki tab Begin of the insertionunder "Mentioned in description"End of the insertion Begin of the deletion since it is also automatically linked with the work package.End of the deletion

* Begin of the deletion The corresponding link will appear in-line.End of the deletion Clicking on this link will take the user to the newly-created page on XWiki.

* When user clicks on Begin of the insertion"ExistingEnd of the insertion Begin of the deletion "AddEnd of the deletion wiki page" the _add wiki page_ dialog will appear:

* The user will be invited to Begin of the insertionenter the provider first

* The user will be invited toEnd of the insertion select a Wiki page.

* Begin of the insertion~~AllEnd of the insertion Begin of the deletion AllEnd of the deletion available wiki pages are shown as tree view with meta information and a Begin of the insertionsearch~~

* AEnd of the insertion search Begin of the insertionis available to find the right pageEnd of the insertion

* The Begin of the insertionuser can also paste a URL of an existing wiki page

* TheEnd of the insertion selected wiki page will appear in the Begin of the insertionwork package description in-line, as well as in theEnd of the insertion Wiki tab Begin of the insertionunder "Mentioned in description"End of the insertion Begin of the deletion since it is also automatically linked with the work package.End of the deletion

* Begin of the deletion The corresponding link will appear in-line.End of the deletion Clicking on this link will take the user to the selected page on XWiki.


### Implementation

* Prerequisites:

* Begin of the insertionSee [document](https://community.openproject.org/documents/192)End of the insertion Begin of the deletion (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 APIEnd of the deletion for Begin of the deletion listing spaces

* (assumed to be present) XWikiEnd of the deletion API Begin of the insertionendpointsEnd of the insertion Begin of the deletion for listing pages, optionally filtering by spaceEnd of the deletion

* (Implementation needed in Begin of the deletion XWiki)End of the deletion XWiki Begin of the deletion API for pages that allow for creating a link to a OpenProject work package

* (Implementation needed in XWikiEnd of the deletion and OpenProject) Bi-directional OAuth setup on administrator level. Defined in ##55601. Begin of the deletion

* Editor macro "Create new wiki page"

* Effort:End of the deletion

Begin of the deletion * 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 (Outdated)

End of the deletion <br> Begin of the insertion


End of the insertion Begin of the deletion

**Macros to add existing or create new wiki page**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/918453/content">

**Select wiki page dialog**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/918454/content">

**Create new wiki page dialog**

<img class="op-uc-image op-uc-image_inline" src="/api/v3/attachments/918456/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/918457/content">

End of the deletion ###