CONTENTS OF THIS FILE
---------------------
   
 * Introduction
 * Requirements
 * Installation
 * Configuration
 * Example
 * Theming and Output
 * Maintainers


INTRODUCTION
------------

The link can be count to the top 50 projects in Drupal installations and
provides a standard custom content field for links. With this module links can
be added easily to any content types and profiles and include advanced
validating and different ways of storing internal or external links and URLs. It
also supports additional link text title, site wide tokens for titles and title
attributes, target attributes, css class attribution, static repeating values,
input conversion, and many more.



REQUIREMENTS
------------

Project in Drupal 7 requires the following modules:

 * Fields API (Fields API is provided already by core)
 * Panels (https://drupal.org/project/panels)

Drupal 8:

 * Link is in core now. No installation needed. Yay! Don't forget to activate
   it. It's deactivated by default.


INSTALLATION
------------

Install as you would normally install a contributed Drupal module. See:
https://drupal.org/documentation/install/modules-themes/modules-7 for further
information.


CONFIGURATION
-------------

 * Configuration is only slightly more complicated than a text field. Link text
   titles for URLs can be made required, set as instead of URL, optional
   (default), or left out entirely. If no link text title is provided, the
   trimmed version of the complete URL will be displayed. The target attribute
   should be set to "_blank", "top", or left out completely (checkboxes provide
   info). The rel=nofollow attribute prevents the link from being followed by
   certain search engines. More info at Wikipedia
   (http://en.wikipedia.org/wiki/Spam_in_blogs#rel.3D.22nofollow.22).


EXAMPLE
-------
If you were to create a field named 'My New Link', the default display of the
link would be:
<em><div class="field_my_new_link" target="[target_value]"><a href="[URL]">
[Title]</a></div></em> where items between [] characters would be customized
based on the user input.

The link project supports both, internal and external URLs. URLs are validated
on input. Here are some examples of data input and the default view of a link:
http://drupal.org results in http://drupal.org, but drupal.org results in
http://drupal.org, while <front> will convert into http://drupal.org and
node/74971 into http://drupal.org/project/link

Anchors and query strings may also be used in any of these cases, including:
node/74971/edit?destination=node/74972<front>#pager


THEMING AND OUTPUT
------------------
Since link module is mainly a data storage field in a modular framework, the
theming and output is up to the site builder and other additional modules. There
are many modules in the Drupal repository, which control the output of fields
perfectly and can handle rules, user actions, markup dependencies, and can vary
the output under many different conditions, with much more efficience and
flexibility for different scenarios. Please check out modules like views,
display suite, panels, etc for such needs


MAINTAINERS
-----------

Current maintainers:
 * John C Fiala (jcfiala) - https://www.drupal.org/user/163643
 * Renato Gonçalves (RenatoG) - https://www.drupal.org/user/3326031
 * Clemens Tolboom (clemens.tolboom) - https://www.drupal.org/user/125814
 * diqidoq - https://www.drupal.org/user/1001934
 * dropcube - https://www.drupal.org/user/37031
 * Tom Kirkpatrick (mrfelton) - https://www.drupal.org/user/305669
 * Sumit Madan (sumitmadan) - https://www.drupal.org/user/1538790
 * Daniel Kudwien (sun) - https://www.drupal.org/user/54136