Mercurial > prosody-modules
view mod_http_index/README.markdown @ 4923:c83b009b5bc5
mod_rest: Add configuration of which stanzas to route to callback
Makes it simpler to build APIs that only handle a certain kind of
stanzas, letting them be handled by the unhandled stanza handler instead
of having to write code to ignore certain kinds of stanzas.
author | Kim Alvefur <zash@zash.se> |
---|---|
date | Sat, 09 Apr 2022 01:04:25 +0200 |
parents | 8992f84ca870 |
children |
line wrap: on
line source
Introduction ============ This module produces a list of enabled HTTP "apps" exposed from Prosody at `http://example.org:5280/`, e.g. [mod\_http\_muc\_log], [mod\_http\_files][doc:modules:mod_http_files] or [mod\_admin\_web]. If you think Prosodys default "root" web page (a 404 error usually) is boring, this might be the module for you! :) Configuration ============= Install and enable like any other module. Also see [Prosodys HTTP documentation](https://prosody.im/doc/http). ``` {.lua} modules_enabled = { -- other modules "http_index"; } ``` # Advanced ## Listing all items By default only HTTP apps that include a human-readable title are listed. This filtering can be disabled by setting: ```lua http_index_list_all = true ``` ## Template The template can be customized by copying the included `http_index.html` and pointing to it with the `http_index_template` setting: ``` lua http_index_template = "/path/to/template.html" ```