Limnoria-doc/use/plugins/shrinkurl.rst

119 lines
2.8 KiB
ReStructuredText

.. _plugin-shrinkurl:
The ShrinkUrl plugin
====================
Commands
--------
.. _command-shrinkurl-xrl:
shrinkurl xrl <url>
^^^^^^^^^^^^^^^^^^^
Returns an xrl.us version of *<url>*.
.. _command-shrinkurl-tiny:
shrinkurl tiny <url>
^^^^^^^^^^^^^^^^^^^^
Returns a TinyURL.com version of *<url>*
.. _command-shrinkurl-ln:
shrinkurl ln <url>
^^^^^^^^^^^^^^^^^^
Returns an ln-s.net version of *<url>*.
.. _plugin-shrinkurl-config:
Configuration
-------------
.. _supybot.plugins.ShrinkUrl.default:
supybot.plugins.ShrinkUrl.default
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: ln
Determines what website the bot will use when shrinking a URL.
.. _supybot.plugins.ShrinkUrl.minimumLength:
supybot.plugins.ShrinkUrl.minimumLength
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: 48
The minimum length a URL must be before the bot will shrink it.
.. _supybot.plugins.ShrinkUrl.nonSnarfingRegexp:
supybot.plugins.ShrinkUrl.nonSnarfingRegexp
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: None
Determines what URLs are to be snarfed; URLs matching the regexp given will not be snarfed. Give the empty string if you have no URLs that you'd like to exclude from being snarfed.
.. _supybot.plugins.ShrinkUrl.outFilter:
supybot.plugins.ShrinkUrl.outFilter
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: False
Determines whether the bot will shrink the URLs of outgoing messages if those URLs are longer than supybot.plugins.ShrinkUrl.minimumLength.
.. _supybot.plugins.ShrinkUrl.serviceRotation:
supybot.plugins.ShrinkUrl.serviceRotation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: []
If set to a non-empty value, specifies the list of services to rotate through for the shrinkSnarfer and outFilter.
.. _supybot.plugins.ShrinkUrl.shrinkSnarfer:
supybot.plugins.ShrinkUrl.shrinkSnarfer
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: False
Determines whether the shrink snarfer is enabled. This snarfer will watch for URLs in the channel, and if they're sufficiently long (as determined by supybot.plugins.ShrinkUrl.minimumLength) it will post a smaller URL from either ln-s.net or tinyurl.com, as denoted in supybot.plugins.ShrinkUrl.default.
.. _supybot.plugins.ShrinkUrl.shrinkSnarfer.showDomain:
supybot.plugins.ShrinkUrl.shrinkSnarfer.showDomain
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: True
Determines whether the snarfer will show the domain of the URL being snarfed along with the shrunken URL.
.. _supybot.plugins.ShrinkUrl.bold:
supybot.plugins.ShrinkUrl.bold
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: True
Determines whether this plugin will bold certain portions of its replies.
.. _supybot.plugins.ShrinkUrl.public:
supybot.plugins.ShrinkUrl.public
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Default value: True
Determines whether this plugin is publicly visible.