allianceauth-wiki-js
Simple User and group management for Wiki JS as a service of AllianceAuth
Wiki-JS service
Simple User and group management for Wiki JS as a service of AllianceAuth
Setup
- install and setup your Wiki.js instance from the Wiki Docs
- activate venv
pip install -U allianceauth-wiki-js
- add
'wikijs',
to yourINSTALLED_APPS
in your projectslocal.py
- generate a
Full Access
API key iun the wiki with maximum expiration be sure to copy it as the key wont be shown again. - add the settings ( outlined below ) to your
local.py
- run migrations and restart auth
- setup permissions ( outlined below )
Permissions
Perm | Codename | Admin | Frontend |
---|---|---|---|
Can access the WikiJS service | access_wikijs | - | Gives access to Wiki.js service |
Can add wiki js | - | Admin add | - |
Can change wiki js | - | Admin Edit | - |
Can delete wiki js | - | Admin Delete | - |
Can view wiki js | - | Admin View | - |
Settings
Setting | default | Description |
---|---|---|
WIKIJS_API_KEY | "" | your global API key from the wiki admin section |
WIKIJS_URL | "" | You Wiki's base URL |
WIKIJS_AADISCORDBOT_INTEGRATION | True | Enables an AADiscordbot cog with the ability to search the wiki |
If you have issues with auth not being able to access the wiki due to SSL/redirection or similar. ( Cloudlfair can cause issues)
Setting | default | Description |
---|---|---|
WIKIJS_API_URL | WIKIJS_URL | URL Overide for API access |
add this setting to your local py with a direct link to the wiki
# if auth is on the same box as wiki
WIKIJS_API_URL = "http://localhost:3000"
# if auth is on a different machine you could use the public ip adress of that machine.
WIKIJS_API_URL = "http://10.0.0.150:3000"
FAQ
- I lost admin when i registered my admin user.
- add a group called
Administrators
to your auth instance and give it to anyone who needs admin on the wiki. - I cant lock down my wiki to registered members only.
- i had to delete a row from the database manually to remove the guest roles permissions. Ask in the AA discord.
No reviews yet...
Python Requirements
- allianceauth<5,>=3
- graphqlclient
- allianceauth-discordbot>=3.8; extra == "discordbot"
Required Python packages to be installed and other Python requirement.
App Dependencies
Required apps:
Used by apps:
-
Dependencies to other apps registered in this app directory.
Classifiers
- Environment :: Web Environment
- Framework :: Celery
- Framework :: Django
- Framework :: Django :: 4.0
- Framework :: Django :: 4.2
- Intended Audience :: Developers
- License :: OSI Approved :: GNU General Public License v3 (GPLv3)
- Operating System :: OS Independent
- Programming Language :: Python
- Programming Language :: Python :: 3 :: Only
- Programming Language :: Python :: 3.10
- Programming Language :: Python :: 3.11
- Programming Language :: Python :: 3.12
- Programming Language :: Python :: 3.8
- Programming Language :: Python :: 3.9
- Programming Language :: Python :: Implementation :: CPython
- Topic :: Internet :: WWW/HTTP
- Topic :: Internet :: WWW/HTTP :: Dynamic Content
Version
0.1.1
License
GPLv3
Homepage
https://github.com/Solar-Helix-Independent-Transport/allianceauth-wiki-js
PyPI
https://pypi.org/project/allianceauth-wiki-js/
Last updated
2 months, 3 weeks ago
First published
4 years, 4 months ago
Category
Services
Rating
-Authors
Aaron Kable
Maintainers
-
Please login to see more options.