{"id":13544991,"url":"https://github.com/FriendsOfFlarum/mason","last_synced_at":"2025-04-02T15:30:51.030Z","repository":{"id":25704281,"uuid":"105202192","full_name":"FriendsOfFlarum/mason","owner":"FriendsOfFlarum","description":"Add custom fields to discussions","archived":false,"fork":false,"pushed_at":"2024-10-04T09:28:02.000Z","size":1001,"stargazers_count":20,"open_issues_count":3,"forks_count":14,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-10-29T22:37:24.260Z","etag":null,"topics":["custom-fields","flagrow","flarum-extension","mason"],"latest_commit_sha":null,"homepage":"https://discuss.flarum.org/d/7028","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FriendsOfFlarum.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"open_collective":"fof"}},"created_at":"2017-09-28T21:44:26.000Z","updated_at":"2024-10-04T09:13:32.000Z","dependencies_parsed_at":"2023-01-14T03:14:18.576Z","dependency_job_id":"6abbf723-c0df-40df-aa7e-12082fa7bab4","html_url":"https://github.com/FriendsOfFlarum/mason","commit_stats":{"total_commits":94,"total_committers":7,"mean_commits":"13.428571428571429","dds":0.276595744680851,"last_synced_commit":"0c153937dd5bee4ff54abbc30e1ee929a3b10978"},"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfFlarum%2Fmason","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfFlarum%2Fmason/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfFlarum%2Fmason/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FriendsOfFlarum%2Fmason/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FriendsOfFlarum","download_url":"https://codeload.github.com/FriendsOfFlarum/mason/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246753493,"owners_count":20828153,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-fields","flagrow","flarum-extension","mason"],"created_at":"2024-08-01T11:00:56.045Z","updated_at":"2025-04-02T15:30:50.594Z","avatar_url":"https://github.com/FriendsOfFlarum.png","language":"JavaScript","funding_links":["https://opencollective.com/fof"],"categories":["Extensions"],"sub_categories":["Discussion ([:top:](#table-of-contents))"],"readme":"# Mason by FriendsOfFlarum\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg) [![Latest Stable Version](https://img.shields.io/packagist/v/fof/mason.svg)](https://packagist.org/packages/fof/mason)\n\nAdd custom fields to your discussions. Features:\n\n- Create custom fields with name, icon and description\n- Fields can be required or optional\n- Fields accept a dropdown selector or user-provided answers\n- User answers can be validated with custom Laravel Validator rules\n- You can choose the number of columns of the layout\n- (experimental) show the tags field as a Mason field\n\n**Note:** due to the way the Flarum discussion composer works, it currently cannot be automatically resized to fit all fields. If you have many fields you will have to manually increase the composer height with the mouse handle.\n\n## Installation\n\n```bash\ncomposer require fof/mason\n```\n\n## Updating\n\n```bash\ncomposer require fof/mason\nphp flarum migrate\nphp flarum cache:clear\n```\n\n## Configuration\n\nOnce enabled, a new Mason tab will show up in the admin.\n\n### Fields\n\nFields can be created, edited and reordered on the page.\nNew fields are immediately visible in the frontend.\n\nIf you delete a field, it will be removed from all discussion that used it.\nFields use a \"soft delete\" feature so the data is preserved in the database even if you delete it.\nYou can bring the field and its answers back by editing the database if you need.\n\n### Answers\n\nAnswers are pre-made answers for a field.\nIf you want to keep an answer visible but prevent new discussions from using it, you can change its suggestion state.\nIf the field accepts user values, these will show up as non-suggested answers.\n\nYou can rename an answer (either admin or user made) and it will be updated everywhere it's used.\n\nDeleting an answer will **permanently** remove it from all discussion using it.\nUnlike fields it doesn't use \"soft deletes\" and as such cannot be recovered.\n\n### Permissions\n\nThe extension comes with several permissions to choose who can interact with custom fields. Check the Permissions tab to configure them.\n\n## Usage\n\nThe custom fields form will display on the discussion composer, on the first post of the discussion and as an option in the discussion edit menu.\nThe layout can be customized via the settings available in the Mason page of the admin panel.\n\n## Updating from Flagrow\n\nThis extension replaces [Flagrow Mason](https://packagist.org/packages/flagrow/mason).\n\n**Please backup your data before attempting the update!**\n\nYou can upgrade from any of the older versions of the Flagrow extension.\n\nThen upgrade from the old extension to the new one:\n\n```sh\ncomposer remove flagrow/mason\ncomposer require fof/mason\n```\n\nWhen you enable the new extension, the permissions, settings and the data from Flagrow Mason will be moved to FoF Mason.\n\n## Links\n\n- [Flarum Discuss post](https://discuss.flarum.org/d/7028)\n- [Source code on GitHub](https://github.com/FriendsOfFlarum/mason)\n- [Report an issue](https://github.com/FriendsOfFlarum/mason/issues)\n- [Download via Packagist](https://packagist.org/packages/fof/mason)\n\nAn extension by [FriendsOfFlarum](https://github.com/FriendsOfFlarum)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFriendsOfFlarum%2Fmason","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FFriendsOfFlarum%2Fmason","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FFriendsOfFlarum%2Fmason/lists"}