Help-Site Computer Manuals
Software
Hardware
Programming
Networking
  Algorithms & Data Structures   Programming Languages   Revision Control
  Protocols
  Cameras   Computers   Displays   Keyboards & Mice   Motherboards   Networking   Printers & Scanners   Storage
  Windows   Linux & Unix   Mac

Netscape::Bookmarks::Link - manipulate, or create Netscape Bookmarks links

Netscape::Bookmarks::Link - manipulate, or create Netscape Bookmarks links


NAME

Netscape::Bookmarks::Link - manipulate, or create Netscape Bookmarks links


SYNOPSIS


  use Netscape::Bookmarks::Bookmarks;

  my $category = Netscape::Bookmarks::Category->new( { ... } );

  my $link = Netscape::Bookmarks::Link->new( {

                TITLE         => 'this is the title',

                DESCRIPTION   => 'this is the description',

                HREF          => 'http://www.perl.org',

                ADD_DATE      => 937862073,

                LAST_VISIT    => 937862073,

                LAST_MODIFIED => 937862073,

                ALIAS_ID      => 4,

                } );

  $category->add($link);

  #print a Netscape compatible file

  print $link->as_string;


DESCRIPTION

The Netscape bookmarks file has several basic components:


        title

        folders (henceforth called categories)

        links

        aliases

        separators

On disk, Netscape browsers store this information in HTML. In the browser, it is displayed under the ``Bookmarks'' menu. The data can be manipulated through the browser interface.

This module allows one to manipulate the links in for a Netscape bookmarks file. A link has these attributes, only some of which may be present:


        title

        description

        HREF (i.e. URL)

        ADD_DATE

        LAST_MODIFIED

        LAST_VISIT

        ALIAS_OF

        ALIAS_ID

These are explained below.

Methods

Netscape::Bookmarks::Link->new( \%hash )
Creates a new Link object. The hash reference argument can have the following keys to set the properties of the link:

        HREF

        ADD_DATE

        LAST_MODIFIED

        LAST_VISIT

        ALIASID

        ALIASOF

$obj->href
Returns the URL of the link. The URL appears in the HREF attribute of the anchor tag.

$obj->add_date
Returns the date when the link was added, in Unix epoch time.

$obj->last_modified
Returns the date when the link was last modified, in Unix epoch time. Returns zero if no information is available.

$obj->last_visit
Returns the date when the link was last vistied, in Unix epoch time. Returns zero if no information is available.

$obj->title
Returns the link title.

$obj->description
Returns the link description.

$obj->alias_id
Returns the alias id of a link. Links with aliases are assigned an ALIAS_ID which associates them with the alias. The alias contains the same value in it's ALIAS_OF field. The Netscape::Bookmarks::Alias module handles aliases as references to Netscape::Bookmarks::Link objects.

$obj->as_string
Returns a Netscape compatible bookmarks file based on the Bookmarks object.


TO DO


        Add methods for manipulating attributes


SOURCE AVAILABILITY

This source is part of a SourceForge project which always has the latest sources in CVS, as well as all of the previous releases.


        http://sourceforge.net/projects/nsbookmarks/

If, for some reason, I disappear from the world, one of the other members of the project can shepherd this module appropriately.


AUTHOR

brian d foy, <bdfoy@cpan.org>


COPYRIGHT AND LICENSE

Copyright (c) 2002-2007 brian d foy. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.


SEE ALSO

the Netscape::Bookmarks manpage

Programminig
Wy
Wy
yW
Wy
Programming
Wy
Wy
Wy
Wy