{"id":13774208,"url":"https://github.com/divio/aldryn-forms","last_synced_at":"2025-05-11T06:32:32.150Z","repository":{"id":9526360,"uuid":"11426455","full_name":"divio/aldryn-forms","owner":"divio","description":"Flexible HTML forms for your django CMS projects","archived":true,"fork":false,"pushed_at":"2024-03-28T09:20:46.000Z","size":699,"stargazers_count":40,"open_issues_count":54,"forks_count":65,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-05-18T20:43:29.263Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/divio.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-07-15T15:25:00.000Z","updated_at":"2024-06-18T22:47:24.051Z","dependencies_parsed_at":"2024-01-13T07:23:58.216Z","dependency_job_id":"634400b0-6442-4cf3-a605-c15afa3fb3e6","html_url":"https://github.com/divio/aldryn-forms","commit_stats":null,"previous_names":["aldryn/aldryn-forms"],"tags_count":80,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/divio%2Faldryn-forms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/divio%2Faldryn-forms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/divio%2Faldryn-forms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/divio%2Faldryn-forms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/divio","download_url":"https://codeload.github.com/divio/aldryn-forms/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225022029,"owners_count":17408539,"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":[],"created_at":"2024-08-03T17:01:24.676Z","updated_at":"2024-11-17T09:30:37.877Z","avatar_url":"https://github.com/divio.png","language":"Python","funding_links":[],"categories":["Add-ons"],"sub_categories":[],"readme":"**Deprecated**\n\nThis project is no longer supported.\n\nDivio will undertake no further development or maintenance of this project. If you are interested in continuing to develop it, use the fork functionality from GitHub. We are not able to transfer ownership of the repository to another party.\n\n================\nAldryn Forms App\n================\n\nAldryn Forms allows you to build flexible HTML forms for your `Aldryn \u003chttp://aldryn.com\u003e`_ and `django CMS\n\u003chttp://www.django-cms.org\u003e`_ projects, and to integrate them directly in your pages.\n\nForms can be assembled using the form builder, with the familiar simple drag-and-drop interface of the django CMS\nplugin system.\n\nSubmitted data is stored in the Django database, and can be explored and exported using the admin, while forms can\nbe configured to send a confirmation message to users.\n\nContributing\n============\n\nThis is a an open-source project. We'll be delighted to receive your\nfeedback in the form of issues and pull requests. Before submitting your\npull request, please review our `contribution guidelines\n\u003chttp://docs.django-cms.org/en/latest/contributing/index.html\u003e`_.\n\nWe're grateful to all contributors who have helped create and maintain this package.\nContributors are listed at the `contributors \u003chttps://github.com/divio/aldryn-forms/graphs/contributors\u003e`_\nsection.\n\nInstallation\n============\n\nAldryn Platform Users\n---------------------\n\nChoose a site you want to install the add-on to from the dashboard. Then go to ``Apps -\u003e Install app`` and click ``Install`` next to ``Forms`` app.\n\nRedeploy the site.\n\nUpgrading from \u003c 2.0\n====================\nVersion 2.0 introduced a new model for form data storage called ``FormSubmission``.\nThe old ``FormData`` model has been deprecated.\nAlthough the ``FormData`` model's data is still accessible through the admin, all new form data will be stored in the new\n``FormSubmission`` model.\n\nManuall Installation\n--------------------\n\nRun ``pip install aldryn-forms``.\n\nUpdate ``INSTALLED_APPS`` with ::\n\n    INSTALLED_APPS = [\n        ...\n        'absolute',\n        'aldryn_forms',\n        'aldryn_forms.contrib.email_notifications',\n        'emailit',\n        'filer',\n        ...\n    ]\n\nConfigure ``aldryn-boilerplates`` (https://pypi.python.org/pypi/aldryn-boilerplates/).\n\nTo use the old templates, set ``ALDRYN_BOILERPLATE_NAME='legacy'``.\nTo use https://github.com/aldryn/aldryn-boilerplate-standard (recommended, will be renamed to\n``aldryn-boilerplate-bootstrap3``) set ``ALDRYN_BOILERPLATE_NAME='bootstrap3'``.\n\nAlso ensure you define an `e-mail backend \u003chttps://docs.djangoproject.com/en/dev/topics/email/#dummy-backend\u003e`_ for your app.\n\n\nCreating a Form\n===============\n\nYou can create forms in the admin interface now. Search for the label ``Aldryn_Forms``.\n\nCreate a CMS page and install the ``Forms`` app there (choose ``Forms`` from the ``Advanced Settings -\u003e Application`` dropdown).\n\nNow redeploy/restart the site again.\n\nThe above CMS site has become a forms POST landing page - a place where submission errors get displayed if there are any.\n\n\nAvailable Plug-ins\n==================\n\n``Form`` plugin lets you embed certain forms on a CMS page.\n\n``Fieldset`` groups fields.\n\n``Text Field`` renders text input.\n\n``Text Area Field`` renders text input.\n\n``Yes/No Field`` renders checkbox.\n\n``Select Field`` renders single select input.\n\n``Multiple Select Field`` renders multiple checkboxes.\n\n``File field`` renders a file upload input.\n\n``Image field`` same as ``file field`` but validates that the uploaded file is an image.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdivio%2Faldryn-forms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdivio%2Faldryn-forms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdivio%2Faldryn-forms/lists"}