Installation of WikiTraccs WikiPakk
The WikiPakk solution has to be installed once in the SharePoint tenant before WikiPakk can be added to sites.
You can install WikiPakk either through the Microsoft Store AppSource, or manually via the tenant app catalog. The next two sections describe those options.
After installing the WikiPakk app to the SharePoint tenant, it can be added to sites by site owners.
Option 1: Installation via Microsoft AppSource
Installing the app via AppSource is covered in this video, as well as adding the app to a site:
Note: Administrative rights are necessary when the app is added the very first time on your SharePoint tenant. You need to be either SharePoint administrator or have administrative rights on the tenant app catalog to install the app right away. Otherwise you can request the app to be installed and an administrator has to confirm this. This has to be done only once for the SharePoint tenant.
Option 2: Installation via Tenant App Catalog
As SharePoint tenant admin install the app:
- Obtain the WikiTraccs-WikiPakk.sppkg solution package from GitHub
- Add WikiTraccs-WikiPakk.sppkg to the SharePoint tenant app catalog and enable the app
As site owner add the app to a site:
- Open the SharePoint site to add WikiPakk to
- Choose the New button, then choose App
- On the My Apps page, in the left navigation, choose From my organization
- Find WikiTraccs WikiPakk and select Add
After adding the app
Head over to the WikiPakk website to learn more.
WikiPakk currently does not check for updates, and neither does SharePoint. New versions can be discovered manually via the AppSource app store.
Checking for a new WikiPakk version on Microsoft AppSource
You can see the latest version of WikiPakk in AppSource on this page: Details + support.
In AppSource there will also be a changelog showing the changes per release:
Changelog of WikiPakk as shown in AppSource
Updating WikiPakk in SharePoint
There are two steps to updating WikiPakk:
- the SharePoint tenant app catalog needs to be updated with the newest version from AppSource
- SharePoint sites that use WikiPakk might need to be updated to use this new version
The following sections describe those steps.
Update the SharePoint tenant app catalog
As SharePoint administrator, open the tenant app catalog as follows:
- in a browser, open the SharePoint admin center
- in the left navigation, select More features
- on the right side, several options to choose from appear; look for the Apps section and select Open:
Entry to the SharePoint tenant app catalog.
- the SharePoint tenant app catalog should show a previously installed version of WikiPakk:
WikiPakk, installed from AppSource, showing version 2.3.1.
- Switch to the classic experience by selecting the classic experience link:
- In the classic experience, in the list of apps, select the WikiTraccs WikiPakk app
- At the top of the page, select the FILES tab to expand the ribbon menu (note: only if the ribbon menu is not yet visible)
- In the ribbon menu, select Upgrade Store App:
You will be redirected to a screen that displays Downloading from: https://addinsinstallation.store.office.com/appinstall/….
Once the file has been downloaded, you will be prompted to trust WikiTraccs WikiPakk:
- Choose Deploy and wait; it might appear that nothing is happening for up to 20 seconds
Once the update has been completed, you should be redirected to the app catalog and the App version number should match the version number listed in AppSource.
Now the new app version is ready to be used in SharePoint sites.
Update WikiPakk in SharePoint sites
Look at the changelog in AppSource!
You only need to update WikiPakk in SharePoint sites if the changelog says that this is necessary.
In most cases it is not necessary to update WikiPakk in sites, although it doesn’t hurt.
Only when the WikiPakk manifest changes (things like app title, but also embedded SharePoint resources like lists), the app needs to be updated in each site for those changes to be applied to the site.
The changelog will highlight that. (But it’s also worth a shot when troubleshooting update issues.)
In SharePoint, an app can have different versions in the tenant app catalog and in sites that the app had been added to.
The previous section described how to update the app from AppSource via the tenant app catalog. This app version is now higher than in the sites that use the app. We need to update those sites as well so they use the latest version.
To update each SharePoint site to the latest WikiPakk version proceed as follows.
As site owner, or site collection administrator of the respective sites:
- In a browser, navigate to a SharePoint site that uses WikiPakk
- In this site, navigate to Site Contents
- For the WikiTraccs WikiPakk app, choose … > Details:
- Choose GET IT to update the app:
After a moment, you will be redirected back to Site Contents. The WikiTraccs WikiPakk app title might display in gray, indicating that the update is still in progress.
After a while (and you might have to refresh the page manually) the app title should display in black, indicating that SharePoint finished updating the app.
For the app, select … > Details again. It should now read Good news - you already have this on your site.
Note: this process can be automated, e.g. with the CLI for Microsoft 365.
You can see the app version as well in WikiPakk as follows:
- Select Page Tree to expand the page tree panel on the right side
- Select the ? that is displayed at the bottom of the page tree; a window opens
- The app version is shown right at the top
If the version shown here is lower than the one of the app you just installed, proceed reading the next section about Caching ssues.
There is one rather ugly behavior when updating SharePoint apps. Sometimes the browser caches old resources rather aggressively, making the app appear being older for users.
This is the case when the version number in the ? dialog of WikiPakk shows a lower version number than the app’s version number.
To solve this different strategies helped different clients:
- Pressing F5 to reload the page
- Clearing the browser cache
- Deleting all service workers via the F12 developer tools
This has to be done in all browsers where caching issues occur.