102 lines
3.6 KiB
Plaintext
102 lines
3.6 KiB
Plaintext
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
|