Like Tom Van Doorslaer explained in his blog post: https://blogs.sap.com/2020/03/11/fiori-plugin-showcase-what-is-it/ , we have created a Fiori plugin showcase. Now in this blog post, I want to show how to share your own Fiori plugin to this showcase in more detail.
You only need to do the following 6 steps manually, the last 2 will happen automatically:
- Create your plugin, you can do this by using the template in the SAP Web IDE or the template provided by Tom: https://gitlab.com/fiddlebe/ui5/templates/plugin
- Put it on GIT, this can be GitHub, GitLab or any other online git repository to share your code
- Publish your Fiori plugin to NPM. (In case you used the SAP Web IDE, you need to clone the repository for this step)
- Fork our repository that contains the list of Fiori plugins: https://github.com/FiddleWookie/FioriLaunchpadExtensions
- Add the name of the NPM package from step 3 to the file “Plugins.txt” on a new line. (Make sure their is an empty line at the end of the file)
- Create a pull request and if the build is successful, we will make the merge for you!
Automatically Travis CI will make sure that your plugin will be added to the Showcase! As soon as the npm cache is updated, you’ll see your plugin in the Fiori Showcase: https://fiddlewookie.github.io/Launchpad/
All steps in detail with my “WhatsNewPlugin” as example:
1. Develop your plugin; I have developed this plugin in the SAP Web IDE but you could also start by using the template from Tom: https://gitlab.com/fiddlebe/ui5/templates/plugin
2. Put it on GIT. I used GitHub for the What’s New plugin which you can find here: https://github.com/lemaiwo/FioriWhatsNewPlugin
You can also use any other online GIT tool like GitLab, BitBucket or anything else you like that supports GIT
3. Publish to NPM. In case you used SAP Web IDE, you won’t be able to publish it to NPM from their. Therefor, you need to clone the repository to your local computer:
Go into the folder of your plugin by using Command line:
Run the command “npm login” in this folder:
Remove private property and make sure the name has no uppercase in the package.json of your plugin:
Finally, publish your plugin to NPM by using the command: “npm publish”
4. Fork our repository : https://github.com/FiddleWookie/FioriLaunchpadExtensions
Do this by going to the repository and click on “Fork”
You will have now your own version of the repository with the ability to make changes:
5. Add your NPM package: Go to your forked repo, open the file “Plugins.txt” and click on edit:
Add your npm package and make sure there is an empty line at the end.
6. Make a pull request: Click on “New pull request” in your forked repo
In the next screen click on “Create pull request”
Fill in a small comment so we know what’s been added and click on “Create pull request”
This will trigger the build process and add your plugin to the Fiori Showcase. We will accept the merge when the build is successful!
When the build is successfully done and the npm cache is updated, you will see your plugin in the Fiori Showcase: https://fiddlewookie.github.io/Launchpad/
Develop and add your plugin to the Fiori Plugin Showcase!!! 🙂