=head1 NAME XML::GSA - Creates xml in google search appliance (GSA) format =head1 VERSION Version 0.01 =head1 SYNOPSIS This is a lib that allows one to create xml in Google Search Appliance (GSA) format. You can use this lib in the following way: use XML::GSA; my $gsa = XML::GSA->new('base_url' => 'http://foo.bar'); my $xml = $gsa->create( [ { 'action' => 'add', 'records' => [ { 'url' => '/aaa', 'mimetype' => 'text/plain', 'action' => 'delete', }, { 'url' => '/bbb', 'mimetype' => 'text/plain', 'metadata' => [ { 'name' => 'og:title', 'content' => 'BBB' }, ], } ], }, ] ); print $xml; Which will output:
Sourceincremental
=head1 METHODS =head2 new( C<$params> ) Create a new XML::GSA object: my $gsa = XML::GSA->new('base_url' => 'http://foo.bar'); Arguments of this method are an anonymous hash of parameters: =head3 datasource Defines the datasource to be included in the header of the xml. =head3 type Defines the type of the feed. This attribute tells the feed what kind of attributes the records are able to receive. =head3 base_url Defines a base url to be preppended to all records' urls. =head2 type( C<$value> ) Getter/setter for the type attribute of GSA feed. By default it is 'incremental'. Possible values are 'incremental', 'full' or 'metadata-and-url' =head2 datasource( C<$value> ) Getter/setter for the datasource attribute of GSA feed. By default it is 'web'. =head2 base_url( C<$value> ) Getter/setter for the base_url attribute of GSA feed. This is an url that will be preppended to all record urls. If a base_url is not defined, one must pass full urls in the records data structure. =head2 create( C<$data> ) Receives an arrayref data structure where each entry represents a group in the xml, generates an xml in GSA format and returns it as a string. Important note: All data passed to create must be in unicode! This class will utf-8 encode it making it compatible with GSA. One can have has many group has one wants, and a group is an hashref with an optional key 'action' and a mandatory key 'records'. The key 'action' can have the values of 'add' or 'delete' and the 'records' key is an array of hashrefs. Each hashref in the array corresponding to 'records' can have the following keys: * Mandatory * url * mimetype => (text/plain|text/html) - in the future it will also support other mimetype * Optional * action => (add|delete) * lock => (true|false) * displayurl => an url * last-modified => a well formatted date as string * authmethod => (none|httpbasic|ntlm|httpsso) * pagerank => an int number * crawl-immediately => (true|false) * crawl-once => (true|false) =head2 create Creates the xml using the groups already added to the object. =head2 add_group( C<$group> ) Receives an hashref data structure representing a group and adds it to the current feed - you must call the `create` method with no arguments to have the xml updated. A group is an hashref with an optional key 'action' and a mandatory key 'records'. The key 'action' can have the values of 'add' or 'delete' and the 'records' key is an array of hashrefs. Each hashref in the array corresponding to 'records' can have the following keys: * Mandatory * url * mimetype => (text/plain|text/html) - in the future it will also support other mimetype * Optional * action => (add|delete) * lock => (true|false) * displayurl => an url * last-modified => a well formatted date as string * authmethod => (none|httpbasic|ntlm|httpsso) * pagerank => an int number * crawl-immediately => (true|false) * crawl-once => (true|false) Important note: All data passed must be in unicode! This class will utf-8 encode it making it compatible with GSA. =head2 add_group( C<$group> ) Receives an instance of the class XML::GSA::Group and adds it to the current feed - you must call the `create` method with no arguments to have the xml updated. =head2 clear_groups Empties the property `groups` of this class. =head2 xml Getter for the xml generated by the `create` method. =head2 to_string Getter for the xml generated by the `create` method. =head2 encoding Getter for the encoding used in this class =head2 groups Getter for the array of groups added to this class =head2 writer Getter for the XML::Writer object used in this class to create the xml =head1 AUTHOR Shemahmforash, C<< >> =head1 BUGS Please report any bugs or feature requests to C, or through the web interface at L. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. =head1 SUPPORT You can find documentation for this module with the perldoc command. perldoc XML::GSA You can also look for information at: =over 4 =item * RT: CPAN's request tracker (report bugs here) L =item * AnnoCPAN: Annotated CPAN documentation L =item * CPAN Ratings L =item * Search CPAN L =item * Github Repository L =back =head1 ACKNOWLEDGEMENTS Great thanks to Andre Rivotti Casimiro for the invaluable suggestions and the help in setting a cpan compatible module. =head1 LICENSE AND COPYRIGHT Copyright 2013 Shemahmforash. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see L.