{
    "info": {
        "author": "Infrae",
        "author_email": "info@infrae.com",
        "bugtrack_url": null,
        "classifiers": [
            "Framework :: Zope2",
            "Programming Language :: Python",
            "Topic :: Internet :: WWW/HTTP :: Dynamic Content :: Message Boards",
            "Topic :: Software Development :: Libraries :: Python Modules"
        ],
        "description": "==============\nsilva.app.news\n==============\n\n``silva.app.news`` is an extension to `Silva`_ 3 to allow authors to\nadd news articles and agenda items in Silva.\n\nFor older versions of Silva, please use an older version of\n``Products.SilvaNews``.\n\nUsing Silva News\n================\n\nThe first thing to do is add subjects and target audiences to the\nservice_news object in the Silva root in the ZMI. This object is used\nonly to manage those lists (subjects and target audiences), these will\nfunction as criteria for the newsfilters (more on these later in this\ndocument) to search on. It would be best to add as much subjects and\ntarget audiences as currently available to the service when setting up\nNews, since the lists are the basis of the filtering system and one\nhas to dive into the ZMI to add items (therefore it requires\nappropriate rights to edit stuff in the ZMI).  Managing these lists is\nquite straightforward: you can add an item by filling in a string into\none of the textfields and pressing on the corresponding 'add' button,\nand remove them by checking the checkbox in front of an item and\nclicking the corresponding 'remove' button.\n\nAdding a News Publication\n-------------------------\n\nNewsitems can only be added to newspublication. To add one, go to the\nSMI and choose 'Silva News Publication' from the menu of addables\n(upper left corner of the edit tab in folders, publications and the\nSilva root). Enter an id and a title and choose 'Add and edit', you\nwill then be taken to the edit tab of the newspublication.  This tab\nlooks a lot like the edit tab of other containers (folders,\npublications) in Silva, except it doesn't have a default document or\nview and can not contain anything other then news items (articles and\nagenda items), folders and publications (thus allowing a more\nstructured setup of the newspublication).You can add newsitems by\nchoosing a specific type from the addables menu in this tab.\n\nProperties tab\n~~~~~~~~~~~~~~\n\nIn the properties tab of newspublication there is a checkbox called\n'restrict access'. When this is checked, the folder can only be found\nby news- and agendafilters in the same folder the folder is on and\neach subfolder of that folder. This can be used to make the\nnewspublication 'private', making it available only to for example 1\ndepartment.\n\nAdding news items\n-----------------\n\nNow authors can add newsitems. As stated before, there are two types\nof newsitems: articles and agendaitems. The main differences are that\nagendaitems must contain a date/time on which the event described in\nthem takes place, and contain a location on which the event takes\nplace. The start date/time is necessary to show the items in\nagendaviewers, since they show the items for a particular period\n(e.g. a month). Therefore agendaviewers can show only\nagendaitems. Newsviewers are capable of showing both articles and\nagendaitems. Other datafields required for the system to work\ncorrectly are 'subjects' and 'target audiences', which the author can\nuse to classify the newsitem. These fields will later be used by the\nnewsfilters as criteria for routing the items to newsviewers. When\nediting an article or agenda item, keep in mind that the first heading\nplaced in the content editor is considered to be the subheader of the\nnewsitem, and the first paragraph as the lead (both will show up in\nthe preview on the viewers).\n\nAdding news filters\n-------------------\n\nThe next thing to do to make the system work is adding one or more\nnews- and agendafilters. These are objects used by editors or chief-\neditors to filter a stream of newsitems. The items can be filtered on\nsubject and target audience (so for instance a newsfilter can route\nonly newsitems with a specific subject or meant for a specific target\naudience to the viewers) and/or individually (per newsitem). Another\nfeature of the filters is the ability to 'stick to the current path',\nwhen set this makes the filters pick up items only if they're in a\nsubdirectory of the filter's container.\n\nThe Filters' edit tab\n~~~~~~~~~~~~~~~~~~~~~\n\nThe contents tab of a newsfilter shows a list of all available\nnewspublications (excluding the ones made private by checking the\n'restrict access' checkbox that are not in the same folder or a\nparentfolder of the newsfilter). To route newsitems of a\nnewspublication to newsviewers (more about those later) make sure the\ncheckbox in front of the newspublication is checked and click the\n'update sources' button. All (published) newsitems that conform to the\ncriteria of the newsfilter will then be routed to the newsviewers that\nuse this filter. These criteria can be set in the 'Properties' tab of\nthe newsfilter: you see the lists of subjects and target audiences of\nservice_news again, and in newsfilters also a couple of radiobuttons\nto select whether the filter should route agendaitems as well as\narticles. These criteria can be used to distribute articles and\nagendaitems in different ways across the Silva instance to\nnewsviewers.\n\nFor example: a number of different newspublications can contain both\narticles and agendaitems of different subjects and targeting different\naudiences, and the newsfilters filter and distribute specific items to\nviewers. Please note that this means that filters must be sensibly set\nup for the site to allow all newsitems to be shown somewhere: it is\nvery easy to set up the system in a way that articles and agendaitems\nwith a specific subject or target audience are filtered out by all\nnewsfilters, and therefore be excluded from all viewers.\n\nThe Items tab\n~~~~~~~~~~~~~\n\nThe 'Items' tab can be used to filter out specific items, to allow\neditors and chiefeditors to disallow specific articles and agendaitems\nto be routed by a filter. To filter out a specific item, uncheck the\ncheckbox in front of it and choose 'update'.\n\nNow the news- and agendaviewers can be placed. The viewers are the\nobjects responsible for showing the articles and agendaitems to the\npublic. An author can place viewers where he wants news to be shown.\nThe viewers show a list of items routed by the filters.\n\nThe Viewer's Edit tab\n---------------------\n\nThe viewers are quite easy to set up: the only tab that matters is the\nfirst one (edit), where you can set the number of days the viewer will\nlook back (for newsviewers) or ahead (for agendaviewers) to get\nitems. In the case of newsviewers there is also a switch to choose a\nnumber of items to be shown. Also there is a list of available\nfilters. All filters chosen here are used for retrieving news. When\nplaced, the viewers will be available to the public and show articles\nand/or agendaitems, together with an archive (that allows showing\nitems for a particular month) and a search option.\n\nAppending /rss to the URL of a NewsViewer will show the RSS 1.0 (RDF\ncompliant) view of the items in this viewer.\n\nThe RSSAggregator\n-----------------\n\nThe RSSAggregator replaces the old (and now removed) RSSViewer. In the\nedit screen you'll see a textbox called 'RSS feeds' where you can enter\nthe complete URLs for the feeds you want to have merged by this\naggregator instance.\n\nAll the other functionality is the same as for News Viewers.\n\n\nCode repository\n===============\n\nYou can find the code of this extension in Git:\nhttps://github.com/silvacms/silva.app.news\n\n.. _Silva: http://silvacms.org\n\nChangeLog\n=========\n\n3.0.4 (2013/12/19)\n------------------\n\n- Change how the dates are displayed in agenda and news items: no\n  longer properly translate them using the local setting. Display the\n  recurrence information.\n\n- Validate and prevent bugs while using subjects and target audiences\n  that have been removed or renamed in the service.\n\n- Improve tests.\n\n3.0.3 (2013/10/09)\n------------------\n\n- An agenda filter can only used by an agenda viewer. Agenda viewer\n  API have been cleaned.\n\n- Extend API usuable by inline news viewer code sources.\n\n- You can now import and export using JSON files subjects and target\n  audiences inside the news service.\n\n- Javascripts widgets have been updated.\n\n- Improve tests.\n\n3.0.2 (2013/05/27)\n------------------\n\n- Force date index to use a 64-bit BTree to store its value.\n\n3.0.1 (2013/03/06)\n------------------\n\n- Update Silva XML import and export API.\n\n- Fix tree widget.\n\n- Improve XML import and export tests.\n\n3.0 (2012/12/11)\n----------------\n\n- A news publication can be used directly by the code source inline\n  news viewers.\n\n- Fix various little bugs in news views when invalid parameters are\n  provided to them (invalid date ranges).\n\n3.0c1 (2012/09/25)\n------------------\n\n- Update API to Silva 3.0c1.\n\n- Various usability improvements.\n\n- Fix bugs.\n\n- Improve tests.\n\n3.0b1 (2011/11/11)\n------------------\n\n- Initial version as a fork of SilvaNews, based on\n  ``silva.app.document`` instead of ``Products.SilvaDocument``, and\n  using ``silva.ui``.",
        "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/silvacms/silva.app.news",
        "keywords": "news silva zope2",
        "license": "BSD",
        "maintainer": null,
        "maintainer_email": null,
        "name": "silva.app.news",
        "package_url": "https://pypi.org/project/silva.app.news/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/silva.app.news/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://github.com/silvacms/silva.app.news"
        },
        "release_url": "https://pypi.org/project/silva.app.news/3.0.4/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "News extension for Silva 3",
        "version": "3.0.4"
    },
    "last_serial": 948742,
    "releases": {
        "3.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "4155cf319f9ec89476067cd3c1a85a4f",
                    "sha256": "5dac13af994ead8091fe4b1ebbc073486888639437aa68be8f9c771978269416"
                },
                "downloads": -1,
                "filename": "silva.app.news-3.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "4155cf319f9ec89476067cd3c1a85a4f",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 392907,
                "upload_time": "2013-12-19T13:38:20",
                "url": "https://files.pythonhosted.org/packages/7e/c6/9b983f63751fcfd41dd5262a9158f989dec121c762cd88d3e5bb1ceee9c5/silva.app.news-3.0.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "4155cf319f9ec89476067cd3c1a85a4f",
                "sha256": "5dac13af994ead8091fe4b1ebbc073486888639437aa68be8f9c771978269416"
            },
            "downloads": -1,
            "filename": "silva.app.news-3.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "4155cf319f9ec89476067cd3c1a85a4f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 392907,
            "upload_time": "2013-12-19T13:38:20",
            "url": "https://files.pythonhosted.org/packages/7e/c6/9b983f63751fcfd41dd5262a9158f989dec121c762cd88d3e5bb1ceee9c5/silva.app.news-3.0.4.tar.gz"
        }
    ]
}