Page Forms

Note	Fork of the MediaWiki extension PageForms, aimed at simplifying contributions by hosting on GitHub instead of Gerrit, improving quality through better test coverage and continuous integration. From time to time, changes in the upstream repository may be cherry-picked and integrated.

Page Forms, previously known as Semantic Forms, is a MediaWiki extension aimed at simplifying data management through forms. In essence, Page Forms allows users to create, edit, and query data on a wiki without the need for coding. The central feature of Page Forms is the form definition pages, located in the 'Form:' namespace. These pages utilize markup code to define forms, empowering users to create and modify forms without requiring programming knowledge. Forms populate predefined templates and page sections, facilitating data storage and querying, especially when used with Semantic MediaWiki.

Documentation

For documentation see: https://www.mediawiki.org/wiki/Extension:Page Forms

Versioning

We use SemVer for versioning. See the tags in this repository for available versions.

Contributing

We welcome contributions from the community to help make Page Forms better! Whether you’re fixing bugs, adding new features, improving documentation, or anything else, your efforts are valuable.

We try to follow the Conventional Commits specification for issues and commit messages to create good and meaningful change logs.

Note	The repository contains submodules. Make sure to clone with --recursive option in Git or by checking the ‘Recursive’ checkbox in TortoiseGit. > git clone --recursive <REPO> If not done when cloning, it can be done by > git submodule init > git submodule update

Click to see detailed Contributing Guidelines

Step 1: Clone the Repository

Fork and clone our repo to your local machine:

git clone https://github.com/username/projectname.git --recursive

Step 2: Ensure test container is running

This repository supports "docker-compose-ci" based CI and testing for MediaWiki extensions.

The docker-compose-ci repository has already been integrated into the Page Forms repository as a Git submodule. It uses "Make" as main entry point and command line interface.

Ensure, you have Make and Docker installed:

make --version
docker --version

Run lint, phpcs and tests:

make ci

Step 3: Start coding

Make sure there is an issue that describes your changes. Create a new branch and start working on your changes. In issue-1234 replace 1234 with your issue number:

git checkout -b issue-1234

Step 4: Test your changes

Ensure that your changes include adequate testing where applicable.

Run lint, phpcs and tests:

make ci

Step 5: Commit your changes

Make sure your commits are well-documented. Try to follow the Conventional Commits specification to help us writing good and meaningful change logs.

git commit -m "Description of your changes"

Step 6: Push! Push your branch and open a pull request.

git push origin feature/your-feature-name

---

This extension is part of semantic::core - Enterprise Class MediaWiki distribution.