Grouper - Documentation
Getting Started: Free Download |
Purchase |
Install
Reference: Functions | Plugins | Themes
Etc.: Configure | Affiliates
Reference: Functions | Plugins | Themes
Etc.: Configure | Affiliates
Atom 1.0 plugin
The Atom 1.0 plugin works with the XML plugin to convert Atom 1.0 feeds to RSS.Installation:
To use the Atom 1.0 plugin, xml.php and atom-1.0.php must be located in the "plugins" folder inside the folder containing grouper.php. This is their default location when Grouper Evolution is installed.
Use:
The following code will read an Atom 1.0 feed and output it as RSS:
<?php
require_once '/YOUR/PATH/TO/grouper/grouper.php';
GrouperLoadPlugin('xml.php');
GrouperLoadPlugin('xml-atom-1.0.php');
GrouperSourceURL('http://example.com/atom.xml');
GrouperShow('','CACHE-FILE-NAME');
?>
Note: if you are using Grouper version 1.4.2 or earlier, you must replace the call to GrouperSourceURL with something like the following:
GrouperSourceConf('searchdomain','example.com');
GrouperSourceConf('querystart','/atom.xml');
Configuration:
This plugin has two configuration options which control whether certain data formats will be accepted from Atom Text Constructs. According to the specification, both of the data types in question indicate that the element should contain a complete document. However, some Atom generators erroneously publish document fragments with these types. If a complete document is found in these types of Text Constructs, accepting them is not recommended, because they are unlikely to be processed correctly in an RSS formatted feed. However, if in a particular case, you know that the Text Constructs specified with these types contain only fragments, you may wish to override these options in order to have Grouper use the data. The options are:
- accept-text-html - 0 to reject content of type "text/html", and 1 to accept it. The default is 0.
- accept-application-xhtml - 0 to reject content of type "application/xhtml", and 1 to accept it. The default is 0.
$xmlgrouperatom10conf['accept-text-html']=1;
$xmlgrouperatom10conf['accept-application-xhtml']=1;