.. _plugin:urlinfo:

=======
URLINFO
=======
| 

about
-----
| 

:author:  Pekka 'raspi' Järvinen - http://raspi.fi/
:contact: FREENODE/#fbf
:distribution: core
:license:  

| 

description
-----------
| 


    Catches URLs on channel and gives information about them like title, image size, etc.
    Uses http://whatisthisfile.appspot.com/ via XMLRPC

    Example:
    19:20 <@raspi> http://www.youtube.com/watch?v=9RZ-hYPAMFQ
    19:20 <@bot> Title: "YouTube - Black Knight Holy Grail"
    19:28 <@raspi> test http://www.raspi.fi foobar http://raspi.fi/wp-includes/images/rss.png
    19:28 <@bot> 1. Title: "raspi.fi" Redirect: http://raspi.fi/  2. Image: 14x14





| 

commands
--------
| 


    :commands in this plugin: urlinfo-enable .. urlinfo-list .. urlinfo-disable

| 

1) *urlinfo-disable .. [handle_urlinfo_disable]*

    :description:  no arguments - disable urlinfo in a channel. 

    :permissions: OPER

    :code: :ref:`fbf.plugs.extra.urlinfo_urlinfo-disable_command`.

    :examples:

    ::

        <user> ;urlinfo-disable
        <output> urlinfo disabled


2) *urlinfo-enable .. [handle_urlinfo_enable]*

    :description:  no arguments - enable urlinfo in a channel. 

    :permissions: OPER

    :code: :ref:`fbf.plugs.extra.urlinfo_urlinfo-enable_command`.

    :examples:

    ::

        <user> ;urlinfo-enable
        <output> urlinfo enabled


3) *urlinfo-list .. [handle_urlinfo_list]*

    :description:  no arguments - list what channels are using urlinfo. 

    :permissions: OPER

    :code: :ref:`fbf.plugs.extra.urlinfo_urlinfo-list_command`.

    :examples:

    ::

        <user> ;urlinfo-list
        <output> urlinfo enabled on channels: #test