{ "info": { "author": "Noe Nieto", "author_email": "noe@iservices.com.mx", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Framework :: Plone", "Intended Audience :: Developers", "Intended Audience :: System Administrators", "License :: OSI Approved", "Programming Language :: Python", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "Introduction\n============\n\n``iservices.controlpanel`` is a plone control panel that provides common\nsettings for themers and integrators. The idea behind this control panel is that\nplone administrators (and not the integrator or programmer) will have the\nability to:\n\n* Define social accounts for use all over the site, specially on themes. The\n programmer/integrator will have to integrate it's product or theme with this\n control panel (hopefully an easy_step) and get this settings to be applied on\n their logic.\n\n* Allows to change the global background and foreground colors that plone uses\n to draw it's interface on plonetheme.sunburs (Actually, only two colors). If the\n user requires more than that, it might be better to craft a complete theme\n product.\n\n* Change the plone logo. The site administrator can change the logo. This\n provides an easy plone theming deployment without the cost of creating a theme\n from scratch just to change the logo.\n\n* Change the footer and colophon text. The site administrator can change the\n text of the footer and colophon without needing the programmer to make changes\n to any theme.\n\nUsage\n=====\n\nInstall using buildout\n-----------------------\n\nAdd ``iservices.controlpanel`` to your ``eggs`` subsection::\n\n eggs = \n ...\n iservices.controlpanel\n\nThis package depends on a set of other packages, hopefully, all packages should\nbe pulled from pypi automatically. However, you'll have to adjust the\n``extends`` subsection according to the following pattern::\n\n extends =\n http://dist.plone.org/release//versions.cfg\n ...\n http://good-py.appspot.com/release/plone.app.z3cform/0.5.0-1?plone=\n http://good-py.appspot.com/release/plone.app.registry/1.0b2?plone=\n\nReplace ```` with the Plone version you are working on, i.e., ``4.0.3``\n\nHow to use it on your packages and themes\n-----------------------------------------\n\nOf course, If you use this package, you'd want access to the settings it\nmanages, right? This package has a small API that encapsulates the the\nboilerplate code and makes it easy to you to use it.\n\nIn order to\naccess the settings of the control panel, you just use a very simple module\nimport::\n\n >>> from iservices.controlpanel.api import settings\n\nAll settings are available using standar Python dot notation. Example::\n\n >>> settings.background_color\n u'#205C90'\n\nIf you access an unknown name, you will get an AttributeError:\n\n >>> registry.some_unknown_key\n Traceback (most recent call last):\n ...\n NameError: name 'registry' is not defined\n \nAlso, using getattr(), even on an existing key name, does not make it:\n\n >>> getattr(settings,background_color)\n Traceback (most recent call last):\n ...\n NameError: name 'background_color' is not defined\n\nSometimes, settings on the control panel will have empty values. It is suggested\nthat, when this happens, the funcionality related to this particular setting\nshould be disabled or modified in some way.\n\n >>> def do_something_with(some_setting):\n ... if some_setting:\n ... print \"Doing stuff when this registry entry is set.\"\n ... else:\n ... print \"Disable functionality when this registry is not set.\"\n ... \n >>> # the twitterlink setting is empty by default\n >>> print settings.twitterlink\n None\n \n >>> do_something_with(settings.twitterlink)\n Disable functionality when this registry is not set.\n \n >>> settings.twitterlink = 'http://twitter.com/tzicatl'\n >>> do_something_with(settings.twitterlink)\n Doing stuff when this registry entry is set.\n \nAnd that's all there is for the API.\n\nCredits\n=======\n\nAuthor\n Noe Nieto \n\nWebsites\n http://iservices.com.mx/\n http://noenieto.com/\n \nContact-email\n desarrollo@iservices.com.mx\n\n\n\nChangelog\n=========\n0.3.1 - March 16th, 2011\n----------------------\n- Rename README.rst -> README.txt\n\n0.3 - March 16th, 2011\n----------------------\n\n- Add tests for the custom css view and fix different problems around. \n\n- Add a browser layer to override the colophon and footer. Also add a\n hacky css stylesheet made out from a zope3 browserview.\n\n0.2 - March 15th, 2011 \n-----------------------\n\n+ First public release with a small set of settings, proper testing and small\n API with documentation.\n \n+ Depends on plone.app.registry, but hopefully, installing this egg alone, will\n pull all the required packages.\n \n+ Tested in Plone 4\n\n0.1 (unreleased yet)\n-------------------\n\n+ Initial release, make all the setuptools boilerplate, and create the git repo.", "description_content_type": null, "docs_url": null, "download_url": "UNKNOWN", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/collective/iservices.controlpanel", "keywords": "plone theme control panel", "license": "GPL", "maintainer": null, "maintainer_email": null, "name": "iservices.controlpanel", "package_url": "https://pypi.org/project/iservices.controlpanel/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/iservices.controlpanel/", "project_urls": { "Download": "UNKNOWN", "Homepage": "https://github.com/collective/iservices.controlpanel" }, "release_url": "https://pypi.org/project/iservices.controlpanel/0.3.1/", "requires_dist": null, "requires_python": null, "summary": "A generic control panel for themers and site integrators", "version": "0.3.1" }, "last_serial": 793451, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "f09ccf4cc18058d621ed4928b5eb3650", "sha256": "b02d3b99f12bd7ac05e76ed163da4858ae9104053a1dbf4e39c2ae2a3fd2a7aa" }, "downloads": -1, "filename": "iservices.controlpanel-0.2.zip", "has_sig": false, "md5_digest": "f09ccf4cc18058d621ed4928b5eb3650", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 27672, "upload_time": "2011-03-15T22:41:22", "url": "https://files.pythonhosted.org/packages/ca/4a/dc90b16f485814a70ddc94c5586c3f9b9fa86f49b305686b9391d1b4d477/iservices.controlpanel-0.2.zip" } ], "0.3": [ { "comment_text": "", "digests": { "md5": "241ac6d3b84716f99db24d85956dbce2", "sha256": "f065f0d04eaf13635a1f02e1bdbf95d663007f9270eeb63c8672190f9c2a5286" }, "downloads": -1, "filename": "iservices.controlpanel-0.3.zip", "has_sig": false, "md5_digest": "241ac6d3b84716f99db24d85956dbce2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 33293, "upload_time": "2011-03-17T03:23:33", "url": "https://files.pythonhosted.org/packages/3d/5d/1d80333be2b23199c3edcdb132644753b001571b8ab0011df288eea2ead3/iservices.controlpanel-0.3.zip" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "da793791668263e702f571bca94c3f91", "sha256": "1b683fe0faad48e33dfe63addc4330e739e5289342ca2e37e742937ef4afedbe" }, "downloads": -1, "filename": "iservices.controlpanel-0.3.1.zip", "has_sig": false, "md5_digest": "da793791668263e702f571bca94c3f91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 33544, "upload_time": "2011-03-17T03:30:55", "url": "https://files.pythonhosted.org/packages/ae/0b/ec30b8072b90d637388234569ebbfb76a2958d6b0d5dbc6a2bd071de3266/iservices.controlpanel-0.3.1.zip" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "da793791668263e702f571bca94c3f91", "sha256": "1b683fe0faad48e33dfe63addc4330e739e5289342ca2e37e742937ef4afedbe" }, "downloads": -1, "filename": "iservices.controlpanel-0.3.1.zip", "has_sig": false, "md5_digest": "da793791668263e702f571bca94c3f91", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 33544, "upload_time": "2011-03-17T03:30:55", "url": "https://files.pythonhosted.org/packages/ae/0b/ec30b8072b90d637388234569ebbfb76a2958d6b0d5dbc6a2bd071de3266/iservices.controlpanel-0.3.1.zip" } ] }