{ "info": { "author": "RedTurtle Technology", "author_email": "sviluppoplone@redturtle.it", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Framework :: Plone", "Framework :: Plone :: 3.3", "Framework :: Plone :: 4.0", "Framework :: Plone :: 4.1", "Framework :: Plone :: 4.2", "Framework :: Plone :: 4.3", "License :: OSI Approved :: GNU General Public License (GPL)", "Programming Language :: Python" ], "description": ".. contents:: **Table of contents**\n :depth: 2\n\nIntroduction\n============\n\nThe *Form Online* product is a Plone add-on composed by three modules:\n\n* `PloneFormGen`__ (needed dependency)\n* `auslfe.formonline.content`__ (needed dependency)\n* A PloneFormGen *adapter* (auslfe.formonline.pfgadapter itself)\n\n__ http://plone.org/products/ploneformgen\n__ http://pypi.python.org/pypi/auslfe.formonline.content\n\nIt is designed for intranets or web sites. Using this, users of the site can handle on-line some company specific\ntasks. Some example:\n\n* ask for technical assistance from the IT Department\n* plan user vacations with the Administration/Human Resource office\n* ask to the administration to buy something expensive\n\nThis is designed keeping in mind not-too-large sized companies.\n\nHow to use it\n=============\n\nThe general structure\n---------------------\n\nThis product is heavily based on the PFG features. You can create the form, where you ask for user information, as you\nwant.\n\n.. image:: http://keul.it/images/plone/auslfe.formonline.pfgadapter-0.2.0-01.png\n :alt: A custom form done using PloneFormGen\n\nThe only required field (but you can name/configure it as you want) is an e-mail field end the user will fill with\nhis overseer address (see below).\n\nAfter that you must use the new *PFG adapter*: Form Online Adapter\n\nBefore being ready to use the form, you need to choose a place (a Folder, or a Large Folder if you think to manage a lot\nof requests).\n\nIf you will use multiple PFG with Form Online Adapter (more than an online form), you can also use multiple\nstorages.\n\nIt's important to know that:\n\n* *every* user that must be able to use a specific Form Online, need to have the *Contributor* role on the storage\n folder (play with the \"Restriction\" link inside the \"Add new\" to limit the user power to create other contents).\n* the user(s) who finally perform the request dispatch must be *Reviewer* on that folder.\n\n.. image:: http://keul.it/images/plone/auslfe.formonline.pfgadapter-0.3.0-01.png\n :alt: An example of configuration of the PFG adapter\n\nDefault Workflow (formonline_workflow)\n--------------------------------------\n\nLet's explaing the default workflow (3-steps).\n\nActors\n~~~~~~\n\nThere are three main actor in the life-cycle of a form:\n\n* the user that \"ask for something\" (A)\n* his *overseer*, that must approve the request (B)\n* the technical user, that dispatch the request and take care that some action will be taken (C)\n\nWhen user A ask for something, he always need to receive user B authorization before any other action can be taken.\n\nTo simplify the process and not being forced to have a Company Organization Chart, is user A itself that \"choose\"\nwho is his overseer. This is done by A writing down the B's e-mail address when filling the form.\n\nWhen saving, user B will receive special power onto the generated form, so he can go there and edit, reject or\napprove the form.\n\nWhen he finally choose to accept the request, the game goes to user C, that is the one who perform some action.\n\nUsers receive e-mail address when the request need their attention.\n\nWait! Is user A that choose user B?!\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nAs said above: this is targeted on small companies. If user A put the e-mail address of someone that isn't is boss,\nor simply is own e-mail (so auto-approving), user C is aways the last step of the procedure. He's responsible to check if\nuser B is really one of the company overseer.\n\nSimple Workflow (formonline_single_steps_workflow)\n--------------------------------------------------\n\nWhen overseer's approval is not necessary \"Simple workflow\" allows end users to submit a form and ask for dispatch\ndirectly.\n\nIn order to achive this goal, \"Form Online\" type has to be configured to use this alternative workflow. You can do\nthis changing the workflow globally for the types, or enabling *CMFPlacefulWorkflow* product, available in\nevery Plone site.\n\nSimple Workflow actors\n~~~~~~~~~~~~~~~~~~~~~~\n\n* the user that \"ask for something\"(A)\n* the technical user, that dispatch the request and take care that some action will be taken (C)\n\nWhen user A ask for something, the request goes directly to C that is the one who perform some action.\n\nUsers receive e-mail address when the request need their attention.\n\nNo user B is needed there.\n\nGenerated content type\n----------------------\n\nThe basic installation of `auslfe.formonline.content`__ try to be simple as possible.\nIt provide a required workflow for working with the PFG Adapter, and the \"Form Online\"\ncontent types.\n\n__ http://pypi.python.org/pypi/auslfe.formonline.content\n\nYou can also choose to use another content type when configuring the adapter, from the\n\"*Document type to generate*\" field.\nThe adapter can work with whatever content type you want (it need to behave a text field, like Page and News\nItems). But in this way you must configure other stuff, like assigning the proper worlflow to the content type\n(globally, or locally using `CMFPlacefulWorkflow`__).\n\n__ http://pypi.python.org/pypi/Products.CMFPlacefulWorkflow\n\nAlternative configuration\n=========================\n\nAnonymous submitter\n-------------------\n\nYou can also configure your Plone site to allow anonymous users to fill the form and generate contents.\nWhat you simply need is to give to ``Anonymous`` role following permission:\n\n* ``auslfe.formonline.content: Add FormOnline``\n* ``Request review``\n\nFor *security reason* is better to give those permissions only onto the folder where you want to store generated\ndocument.\n\nYou can do this using a specific workflow for that folder (maybe using a workflow policy)\nor (**not suggested**) simply giving this permission directly from ZMI on the target folder.\n\nIn that case you can also use the \"*Name of the form field that keep the sender e-mail*\" adapter field,\nso the anonymous user can leave his e-mail, to be notified later.\n\nAnonymous overseer\n------------------\n\nIf you want the overseer e-mail address to be (potentially) an *external* address, you can take a look at\n`auslfe.formonline.tokenaccess`__.\n\n__ http://pypi.python.org/pypi/auslfe.formonline.tokenaccess\n\nDependencies\n============\n\nThis product has been tested with:\n\n* Plone 3.3 (PloneFormGen 1.6.5)\n* Plone 4.2 (PloneFormGen 1.7.1)\n\nTODO\n====\n\n* We are planning an integration of the PFG adapter with `Easy Template`__\n* Automatically save the overseer e-mail in the user data, so automatically fill future requests\n\n__ http://pypi.python.org/pypi/collective.easytemplate/\n\nCredits\n=======\n\nDeveloped with the support of:\n\n* `Azienda USL Ferrara`__\n \n .. image:: http://www.ausl.fe.it/logo_ausl.gif\n :alt: Azienda USL's logo\n \n* `S. Anna Hospital, Ferrara`__\n\n .. image:: http://www.ospfe.it/ospfe-logo.jpg \n :alt: S. Anna Hospital - logo\n\nAll of them supports the `PloneGov initiative`__.\n\n__ http://www.ausl.fe.it/\n__ http://www.ospfe.it/\n__ http://www.plonegov.it/\n\nAuthors\n=======\n\nThis product was developed by RedTurtle Technology team.\n\n.. image:: http://www.redturtle.it/redturtle_banner.png\n :alt: RedTurtle Technology Site\n :target: http://www.redturtle.it/\n\n\nChangelog\n=========\n\n0.7.2 (2014-10-28)\n------------------\n\n- Fixed translations [keul]\n\n0.7.1 (2012-10-03)\n------------------\n\n* Fixed italian translations [keul]\n* Raised the subject's field default size [keul]\n* Fixed dependencies [keul]\n* Fixed a bug: \"edit\" power were tested on\n the adapter object, not form online [keul]\n\n0.7.0 (2012-09-17)\n------------------\n\n* a new workflow has been added (simple workflow) [nicola.senno]\n* redirect check. If the owner doesn't have \"Modify portal content\" permission\n it won't be able to modify the document after submission.\n\n0.6.0 (2012-07-12)\n------------------\n\nUpdated to Plone 4.2\n\n* fix translation of mail_text_rejected, missed literal block [fdelia]\n* added fields to FormOnlineAdapter for subject and text of notification email [fdelia]\n* moved fields related to work with anonymous to a separate fieldset [keul]\n* now the required e-mail field names are taken from a dropdown of all PFG string field\n (do not need to write it manually anymore) [keul]\n* enable by default the \"withtypes\" profile of ``auslfe.formonline.content`` [keul]\n\n0.5.0 (2012-01-20)\n------------------\n\n* removed old unused code [keul]\n* moved the form-filling procedure to a ``IFormOnlineComposer`` adapter: 3rd party code\n could customize how the ``IFormOnline`` is filled [keul]\n* added a new \"*Name of the form field that keep the sender e-mail*\" field in the\n adapter (for use the product with anonymous submitters) [keul]\n\n0.4.1 (2012-01-15)\n------------------\n\n* FormOnlineAdapter now removed from searchable/navigation types [keul]\n* a general approach to the e-mail adapter, simpler for developers to customize it using\n a browserlayer interface [keul]\n\n0.4.0 (2012-01-11)\n------------------\n\n* fixed translations [keul]\n* added a soft dependency on ``auslfe.formonline.tokenacces`` [keul]\n\n0.3.0 (2011-12-13)\n------------------\n\nFirst pubic release\n\n* documentation fixes\n* light support for \"Site Administrator\" role (this **not** mean that we tested this on Plone 4.1 yet)\n [keul]\n* added a new \"contentToGenerate\" field, for choosing the content type to be generated [keul]\n\n0.2.0 (2011-05-06)\n------------------\n\n* better i18ndude support [keul]\n* mail sending refactoring [keul]\n* added an ``Unauthorized`` check in the current user can't write in the storage\n folder [keul]\n* translations changes [keul]\n* added documentation and manual [keul]\n* egg cleanup and dependencies checks [keul]\n\n0.1.0 (2010-07-19)\n------------------\n\n* Initial release [fdelia]", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://plone.org/products/auslfe.formonline.pfgadapter", "keywords": "plonegov form plone", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "auslfe.formonline.pfgadapter", "package_url": "https://pypi.org/project/auslfe.formonline.pfgadapter/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/auslfe.formonline.pfgadapter/", "project_urls": { "Download": "UNKNOWN", "Homepage": "http://plone.org/products/auslfe.formonline.pfgadapter" }, "release_url": "https://pypi.org/project/auslfe.formonline.pfgadapter/0.7.2/", "requires_dist": null, "requires_python": null, "summary": "An adapter for PloneFormGen that add to Plone a way for manage online forms submission", "version": "0.7.2" }, "last_serial": 1771393, "releases": { "0.3.0": [ { "comment_text": "", "digests": { "md5": "274d742f413e2155a64409b4a6020528", "sha256": "1fcfd5748c1bbfe20b3a75aa58c109abd993b7b3a7b488d29558cb8de875453e" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.3.0.tar.gz", "has_sig": false, "md5_digest": "274d742f413e2155a64409b4a6020528", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 19854, "upload_time": "2011-12-13T16:33:18", "url": "https://files.pythonhosted.org/packages/b9/7c/09508bded65b334e9c66b607737d391f4036eeb07134fb8077ab56c6f7d5/auslfe.formonline.pfgadapter-0.3.0.tar.gz" } ], "0.4.0": [ { "comment_text": "", "digests": { "md5": "de488a426bbc9232d12818e6a880f932", "sha256": "5cfdbaed303eb2f3691ad6de8034bd9f32b7a72e07934b1a3187a4f09c5a9d5a" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.4.0.tar.gz", "has_sig": false, "md5_digest": "de488a426bbc9232d12818e6a880f932", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21355, "upload_time": "2012-01-11T09:45:08", "url": "https://files.pythonhosted.org/packages/bb/fd/8ec7d9aa7c850716e714a56ff7302a178ad9ea936d38f86e74d5f2ca8919/auslfe.formonline.pfgadapter-0.4.0.tar.gz" } ], "0.4.1": [ { "comment_text": "", "digests": { "md5": "f434950cb31337401c8ba6bf39d39064", "sha256": "eec7f319eae393800414f083dd59973a7f7dbeb3e1ca2f3106b7abcd5a171924" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.4.1.tar.gz", "has_sig": false, "md5_digest": "f434950cb31337401c8ba6bf39d39064", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 21630, "upload_time": "2012-01-15T16:17:07", "url": "https://files.pythonhosted.org/packages/e1/45/d9f9892708f6045cbd0740a260f16ffa9c4081be7c4fb200c5c0fb26d031/auslfe.formonline.pfgadapter-0.4.1.tar.gz" } ], "0.5.0": [ { "comment_text": "", "digests": { "md5": "faf4869a2f92ad14653b231dba4406a9", "sha256": "8bba51a57122bd2515ddb10d79df0f6491f0e1c2cf6137f16967df185a799365" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.5.0.tar.gz", "has_sig": false, "md5_digest": "faf4869a2f92ad14653b231dba4406a9", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 23050, "upload_time": "2012-01-20T17:36:32", "url": "https://files.pythonhosted.org/packages/ec/36/d9132e4fc0467f5a8ee162b8073785d6819fc903105cc9be7429791ed643/auslfe.formonline.pfgadapter-0.5.0.tar.gz" } ], "0.6.0": [ { "comment_text": "", "digests": { "md5": "735ef0d4d0d2f242c90d818a718ca7ff", "sha256": "938cdcf077c4adcd124235d5189d06f43a1bc6643b8b3228a9007c58fccfc877" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.6.0.zip", "has_sig": false, "md5_digest": "735ef0d4d0d2f242c90d818a718ca7ff", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 57899, "upload_time": "2012-07-12T17:38:17", "url": "https://files.pythonhosted.org/packages/1b/65/c8a59f5728819360bceae6a44c64233b4b94ff8bfda709be6925dffdba13/auslfe.formonline.pfgadapter-0.6.0.zip" } ], "0.7.0": [ { "comment_text": "", "digests": { "md5": "8afda340145ad0bf48fa64c13d11ed2d", "sha256": "2023ad8f846cdde88673f611c491c3fa126f7c77b5b57ff95756792937355838" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.7.0.zip", "has_sig": false, "md5_digest": "8afda340145ad0bf48fa64c13d11ed2d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59007, "upload_time": "2012-09-17T15:09:05", "url": "https://files.pythonhosted.org/packages/37/3b/947f591f1b29235e27932329afd3ee8fec033d1a2ade69ce96be37ed50da/auslfe.formonline.pfgadapter-0.7.0.zip" } ], "0.7.1": [ { "comment_text": "", "digests": { "md5": "1b0779abc5b891e5f1b7181e435e105d", "sha256": "ef6d69ab7841de56b9c42d55c136a941c1ccef94cf9f73c91355008df4bd2331" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.7.1.zip", "has_sig": false, "md5_digest": "1b0779abc5b891e5f1b7181e435e105d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 59682, "upload_time": "2012-10-03T14:12:09", "url": "https://files.pythonhosted.org/packages/26/1d/faf43fed2e5ebb6fe5431336bbc1b9f16d67fbfcc258b91f7a281e428da4/auslfe.formonline.pfgadapter-0.7.1.zip" } ], "0.7.2": [ { "comment_text": "", "digests": { "md5": "1a7d9b02789203cdba5e1507287aae91", "sha256": "1d1059d74507624a003319ef9d86b671b932705980203df0690db711e4d2883e" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.7.2.zip", "has_sig": false, "md5_digest": "1a7d9b02789203cdba5e1507287aae91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63616, "upload_time": "2014-10-28T13:38:56", "url": "https://files.pythonhosted.org/packages/a8/4a/e1bff5fa9341fdecc5e3185a7d7761a79cdd9cd4b64e65a3f9e97f975bb9/auslfe.formonline.pfgadapter-0.7.2.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "1a7d9b02789203cdba5e1507287aae91", "sha256": "1d1059d74507624a003319ef9d86b671b932705980203df0690db711e4d2883e" }, "downloads": -1, "filename": "auslfe.formonline.pfgadapter-0.7.2.zip", "has_sig": false, "md5_digest": "1a7d9b02789203cdba5e1507287aae91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 63616, "upload_time": "2014-10-28T13:38:56", "url": "https://files.pythonhosted.org/packages/a8/4a/e1bff5fa9341fdecc5e3185a7d7761a79cdd9cd4b64e65a3f9e97f975bb9/auslfe.formonline.pfgadapter-0.7.2.zip" } ] }