21 lines
1.8 KiB
Markdown
21 lines
1.8 KiB
Markdown
`The README.md typically serves as a guide for using the extension.`
|
|
|
|
# MyExtension - An [LNbits](https://github.com/lnbits/lnbits) Extension
|
|
|
|
## A Starter Template for Your Own Extension
|
|
|
|
Ready to start hacking? Once you've forked this extension, you can incorporate functions from other extensions as needed.
|
|
|
|
### How to Use This Template
|
|
|
|
> This guide assumes you're using this extension as a base for a new one, and have installed LNbits using https://github.com/lnbits/lnbits/blob/main/docs/guide/installation.md#option-1-recommended-poetry.
|
|
|
|
1. Install and enable the extension either through the official LNbits manifest or by adding https://raw.githubusercontent.com/lnbits/myextension/main/manifest.json to `"Server"/"Server"/"Extension Sources"`.  
|
|
|
|
2. `Ctrl c` shut down your LNbits installation.
|
|
3. Download the extension files from https://github.com/lnbits/myextension to a folder outside of `/lnbits`, and initialize the folder with `git`. Alternatively, create a repo, copy the myextension extension files into it, then `git clone` the extension to a location outside of `/lnbits`.
|
|
4. Remove the installed extension from `lnbits/lnbits/extensions`.
|
|
5. Create a symbolic link using `ln -s /home/ben/Projects/<name of your extension> /home/ben/Projects/lnbits/lnbits/extensions`.
|
|
6. Restart your LNbits installation. You can now modify your extension and `git push` changes to a repo.
|
|
7. When you're ready to share your manifest so others can install it, edit `/lnbits/myextension/manifest.json` to include the git credentials of your extension.
|
|
8. IMPORTANT: If you want your extension to be added to the official LNbits manifest, please follow the guidelines here: https://github.com/lnbits/lnbits-extensions#important
|