view mod_adhoc_dataforms_demo/README.markdown @ 4876:0f5f2d4475b9

mod_http_xep227: Add support for import via APIs rather than direct store manipulation In particular this transitions PEP nodes and data to be imported via mod_pep's APIs, fixing issues with importing at runtime while PEP data may already be live in RAM. Next obvious candidate for this approach is rosters, so clients get immediate roster pushes and other special handling (such as emitting subscribes to reach the desired subscription state).
author Matthew Wild <mwild1@gmail.com>
date Tue, 18 Jan 2022 17:01:18 +0000
parents d56cb74a0db8
children
line wrap: on
line source

---
summary: 'Module for testing ad-hoc commands and dataforms rendering'
---

# Introduction

This module provides [Ad-Hoc commands][xep0050] for testing [data
form][xep0004] that includes all kinds of fields. It's meant to help
debug both Prosodys
[`util.dataforms`][doc:developers:util:dataforms] library and
clients, eg seeing how various field types are rendered.

# Configuration

Simply add it to [`modules_enabled`][doc:modules_enabled] like any
other module.

``` {.lua}
modules_enabled = {
    -- All your other modules etc
    "adhoc_dataforms_demo";
}
```

# Usage

In your Ad-Hoc capable client, first look for "Execute command". You
should see a form with various kinds of fields.

Dataforms Demo
:   A simple command that provides a dataform with every possible field
    type, suitable for testing rending of dataforms.

Multi-step command demo
:   A command that has multiple steps, suitable for testing back and
    forwards navigation.