Sunil Mohan Adapa 900c0d30b9
*: Drop module level app property
module.app property usage is greatly reduced because setup() and force_upgrade()
method are now part of App class instead of at the module level. Remove the
remaining minor cases of usage and drop the property altogether.

Signed-off-by: Sunil Mohan Adapa <sunil@medhas.org>
Reviewed-by: James Valleroy <jvalleroy@mailbox.org>
2022-08-15 10:36:29 -04:00

118 lines
4.4 KiB
Python

# SPDX-License-Identifier: AGPL-3.0-or-later
"""
FreedomBox app to configure ikiwiki.
"""
from django.urls import reverse_lazy
from django.utils.translation import gettext_lazy as _
from plinth import actions
from plinth import app as app_module
from plinth import cfg, frontpage, menu
from plinth.modules.apache.components import Webserver
from plinth.modules.backups.components import BackupRestore
from plinth.modules.firewall.components import Firewall
from plinth.modules.users.components import UsersAndGroups
from plinth.package import Packages
from plinth.utils import format_lazy
from . import manifest
_description = [
_('ikiwiki is a simple wiki and blog application. It supports '
'several lightweight markup languages, including Markdown, and '
'common blogging functionality such as comments and RSS feeds.'),
format_lazy(
_('Only {box_name} users in the <b>admin</b> group can <i>create</i> '
'and <i>manage</i> blogs and wikis, but any user in the <b>wiki</b> '
'group can <i>edit</i> existing ones. In the <a href="{users_url}">'
'User Configuration</a> you can change these '
'permissions or add new users.'), box_name=_(cfg.box_name),
users_url=reverse_lazy('users:index'))
]
class IkiwikiApp(app_module.App):
"""FreedomBox app for Ikiwiki."""
app_id = 'ikiwiki'
_version = 1
def __init__(self):
"""Create components for the app."""
super().__init__()
info = app_module.Info(app_id=self.app_id, version=self._version,
name=_('ikiwiki'), icon_filename='ikiwiki',
short_description=_('Wiki and Blog'),
description=_description, manual_page='Ikiwiki',
clients=manifest.clients,
donation_url='https://ikiwiki.info/tipjar/')
self.add(info)
menu_item = menu.Menu('menu-ikiwiki', info.name,
info.short_description, info.icon_filename,
'ikiwiki:index', parent_url_name='apps')
self.add(menu_item)
packages = Packages('packages-ikiwiki', [
'ikiwiki', 'libdigest-sha-perl', 'libxml-writer-perl',
'xapian-omega', 'libsearch-xapian-perl', 'libimage-magick-perl',
'gcc', 'git', 'librpc-xml-perl', 'libcgi-session-perl',
'libcgi-formbuilder-perl', 'libc6-dev'
])
self.add(packages)
firewall = Firewall('firewall-ikiwiki', info.name,
ports=['http', 'https'], is_external=True)
self.add(firewall)
webserver = Webserver('webserver-ikiwiki', 'ikiwiki-plinth',
urls=['https://{host}/ikiwiki'])
self.add(webserver)
groups = {'wiki': _('View and edit wiki applications')}
users_and_groups = UsersAndGroups('users-and-groups-ikiwiki',
groups=groups)
self.add(users_and_groups)
backup_restore = BackupRestore('backup-restore-ikiwiki',
**manifest.backup)
self.add(backup_restore)
def post_init(self):
"""Perform post initialization operations."""
self.refresh_sites()
def add_shortcut(self, site, title):
"""Add an ikiwiki shortcut to frontpage."""
shortcut = frontpage.Shortcut('shortcut-ikiwiki-' + site, title,
icon=self.info.icon_filename,
url='/ikiwiki/' + site,
clients=self.info.clients)
self.add(shortcut)
return shortcut
def remove_shortcut(self, site):
"""Remove an ikiwiki shortcut from frontpage."""
component = self.remove('shortcut-ikiwiki-' + site)
component.remove() # Remove from global list.
def refresh_sites(self):
"""Refresh blog and wiki list"""
sites = actions.run('ikiwiki', ['get-sites']).split('\n')
sites = [name.split(' ', 1) for name in sites if name != '']
for site in sites:
if not 'shortcut-ikiwiki-' + site[0] in self.components:
self.add_shortcut(site[0], site[1])
return sites
def setup(self, old_version):
"""Install and configure the app."""
super().setup(old_version)
actions.superuser_run('ikiwiki', ['setup'])
self.enable()