{
    "info": {
        "author": "RedTurtle Technology",
        "author_email": "sviluppoplone@redturtle.it",
        "bugtrack_url": null,
        "classifiers": [
            "Framework :: Plone",
            "Framework :: Plone :: 4.3",
            "Programming Language :: Python"
        ],
        "description": "Easily **subscribe** new user to you Plone site by using a **custom PloneFormGen join form**  \r\n\r\n.. contents:: **Table fo contents**\r\n\r\nIntroduction\r\n============\r\n\r\nThe scope of this add-on is to collect join request to your site without enabling the\r\n\"*Enable self-registration*\" option in the security control panel.\r\n\r\nEvery join request is stored in a new PloneFormGen adapter called \"**User Join Adapter**\", then\r\nsite administrator or other power users can \"confirm\" the request (and create a new site's member)\r\nor discard it.\r\n\r\nConfiguration\r\n=============\r\n\r\nPloneFormGen form\r\n-----------------\r\n\r\nFirst of all create you Form Folder with all the fields you want to use.\r\nNot every field you use must be used as user data, for example you can required fields that will\r\nbe used by other adapters.\r\n\r\nFields you must include are the ones that ask for the new userid and (probably) the email.\r\nThe password field is not required (and will not be used) because the adapter will rely onto the Plone\r\nnative password reset feature.\r\n\r\n.. image:: https://raw.githubusercontent.com/PloneGov-IT/collective.pfg.userjoin/7ade30d07f94d2e127b780eb0cf2a9cd94a7152a/docs/collective.pfg.userjoin.0.1.0-01.png\r\n   :alt: Form filling example\r\n\r\n**Please note** that a captcha protection is probably something you don't want to miss.\r\nSee the PloneFormGen documentation for more.\r\n\r\nAdapter configuration\r\n---------------------\r\n\r\nNow create the adapter.\r\n\r\n.. image:: https://raw.githubusercontent.com/PloneGov-IT/collective.pfg.userjoin/7ade30d07f94d2e127b780eb0cf2a9cd94a7152a/docs/collective.pfg.userjoin.0.1.0-04.png\r\n   :alt: Adapter edit form\r\n\r\nYou must properly configure the \"*Userid form field*\", where you must select the form field where you plan to\r\nask form username.\r\n\r\nThe same must be done for \"*Email form field*\" and (optionally) \"*Fullname form field*\".\r\n\r\nPlease remember to enable the adapter in the PloneFormGen edit form.\r\n\r\nAdvanced user configuration\r\n---------------------------\r\n\r\nYour user configuration fieldset can be different from the Plone default, for example you can have a complex\r\nconfiguration that ask for additional informations like phone number, SSN, ...\r\n\r\nYou can handle this by also filling the \"*Map additional user's data*\" field.\r\nFor every user properties on the right you can select which form field (on the left) must be used to populate\r\nthat user info when the user will be finally created.\r\n\r\nGroups\r\n------\r\n\r\nYou can configure the adapter to automatically add users to one or more groups when the join request\r\nwill be confirmed.\r\n\r\nManage join requests\r\n====================\r\n\r\nBy navigate to the adapter a list of join requests is provided.\r\n\r\n.. image:: https://raw.githubusercontent.com/PloneGov-IT/collective.pfg.userjoin/7ade30d07f94d2e127b780eb0cf2a9cd94a7152a/docs/collective.pfg.userjoin.0.1.0-02.png\r\n   :alt: Show join requests\r\n\r\nThe table will recap all form fields that you included in the adapter configuration, showing values provided\r\nat the form submission.\r\nPlease note that *every* form field provided is stored (you can preview all of the data by clicking on the userid link).\r\n\r\nThen you can *confirm* join requests, that means you will create one or more new members, or discard them deleting\r\nthe data.\r\n\r\nAs said above, this product will not handle passwords so after a request is confirmed the default site reset password\r\nfeature is triggered: the user will receive the standard password reset email.\r\n\r\nAdvanced usage\r\n==============\r\n\r\nIntegration with Email adapter\r\n------------------------------\r\n\r\nThis product will not send any email so you probably like to use the standard PloneFormGen mailer adapter\r\nif you need to warn power user to evaluate new submissions.\r\nTo help in this a ``@@join-detail`` view is provided.\r\n\r\n.. image:: https://raw.githubusercontent.com/PloneGov-IT/collective.pfg.userjoin/7ade30d07f94d2e127b780eb0cf2a9cd94a7152a/docs/collective.pfg.userjoin.0.1.0-03.png\r\n   :alt: Show/Confirm a single join request\r\n\r\nThe adapter will add two new request informations you can use in the mailer (adapter execution orders matters):\r\n\r\n``pfguserjoin_obj``\r\n  Adapter object\r\n``pfguserjoin_newid``\r\n  Record id of the request\r\n\r\nFor example you can edit the \"*Mail-Body Template*\" as follow::\r\n\r\n    <html xmlns=\"http://www.w3.org/1999/xhtml\">\r\n    \r\n      <head><title></title></head>\r\n    \r\n      <body>\r\n        <p tal:content=\"here/getBody_pre | nothing\" />\r\n        <dl>\r\n            <tal:block repeat=\"field options/wrappedFields | nothing\">\r\n                <dt tal:content=\"field/fgField/widget/label\" />\r\n                <dd tal:content=\"structure python:field.htmlValue(request)\" />\r\n            </tal:block>\r\n        </dl>\r\n        <p tal:content=\"here/getBody_post | nothing\" />\r\n        <pre tal:content=\"here/getBody_footer | nothing\" />\r\n        <p>Go to the\r\n            <a tal:attributes=\"href string:${request/pfguserjoin_obj/absolute_url}/@@join-detail?id:int=${request/pfguserjoin_newid}\">\r\n                subscription confirmation page\r\n            </a>\r\n        </p>\r\n      </body>\r\n    </html>\r\n\r\nAdvanced security\r\n-----------------\r\n\r\nBy default this add-on will limit dangerous features to Managers and Site administrators.\r\nPlease note that a badly configured adapter can open your site to security issues.\r\n\r\n``collective.pfg.userjoin: Edit Awkward Fields``\r\n  This permission is the one that controls who can edit problematic adapter fields\r\n  (user configuration, groups, ...)\r\n``collective.pfg.userjoin: Manage Join Attempts``\r\n  This permission is the one that controls who can confirm join requests or discard them\r\n``collective.pfg.userjoin: View Sentive Data``\r\n  By playing with this permission you can limit people able to see submitted data.\r\n\r\nCredits\r\n=======\r\n\r\nDeveloped with the support of `S. Anna Hospital, Ferrara`__; S. Anna Hospital supports the\r\n`PloneGov initiative`__.\r\n\r\n__ http://www.ospfe.it/\r\n__ http://www.plonegov.it/\r\n\r\nAuthors\r\n=======\r\n\r\nThis product was developed by RedTurtle Technology team.\r\n\r\n.. image:: http://www.redturtle.it/redturtle_banner.png\r\n   :alt: RedTurtle Technology Site\r\n   :target: http://www.redturtle.it/\r\n\r\nChangelog\r\n=========\r\n\r\n0.1.0 (2015-07-10)\r\n------------------\r\n\r\n- Initial release",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://plone.org/products/collective.pfg.userjoin",
        "keywords": "plone plonegov ploneformgen user subscription",
        "license": "GPL",
        "maintainer": "",
        "maintainer_email": "",
        "name": "collective.pfg.userjoin",
        "package_url": "https://pypi.org/project/collective.pfg.userjoin/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/collective.pfg.userjoin/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://plone.org/products/collective.pfg.userjoin"
        },
        "release_url": "https://pypi.org/project/collective.pfg.userjoin/0.1.0/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "A PloneFormGen adapter for subscribe users to the site",
        "version": "0.1.0"
    },
    "last_serial": 1771617,
    "releases": {
        "0.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "684fbc9e511f546e0c87b97027d5f0b8",
                    "sha256": "0fb994f591d2134b3b8f897d5e0aedb8ecc37d56831747bcddc77515e4b700ab"
                },
                "downloads": -1,
                "filename": "collective.pfg.userjoin-0.1.0.tar.gz",
                "has_sig": false,
                "md5_digest": "684fbc9e511f546e0c87b97027d5f0b8",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 157629,
                "upload_time": "2015-07-10T08:23:39",
                "url": "https://files.pythonhosted.org/packages/39/d9/46970630853ecf2b64dbfe96182ee4f99abdb9f107fb08b102a9a02a2967/collective.pfg.userjoin-0.1.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "684fbc9e511f546e0c87b97027d5f0b8",
                "sha256": "0fb994f591d2134b3b8f897d5e0aedb8ecc37d56831747bcddc77515e4b700ab"
            },
            "downloads": -1,
            "filename": "collective.pfg.userjoin-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "684fbc9e511f546e0c87b97027d5f0b8",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 157629,
            "upload_time": "2015-07-10T08:23:39",
            "url": "https://files.pythonhosted.org/packages/39/d9/46970630853ecf2b64dbfe96182ee4f99abdb9f107fb08b102a9a02a2967/collective.pfg.userjoin-0.1.0.tar.gz"
        }
    ]
}