|
1
|
CONTENTS OF THIS FILE
|
|
2
|
---------------------
|
|
3
|
|
|
4
|
* Introduction
|
|
5
|
* Requirements
|
|
6
|
* Installation
|
|
7
|
* Configuration
|
|
8
|
* Example
|
|
9
|
* Theming and Output
|
|
10
|
* Maintainers
|
|
11
|
|
|
12
|
|
|
13
|
INTRODUCTION
|
|
14
|
------------
|
|
15
|
|
|
16
|
The link can be count to the top 50 projects in Drupal installations and
|
|
17
|
provides a standard custom content field for links. With this module links can
|
|
18
|
be added easily to any content types and profiles and include advanced
|
|
19
|
validating and different ways of storing internal or external links and URLs. It
|
|
20
|
also supports additional link text title, site wide tokens for titles and title
|
|
21
|
attributes, target attributes, css class attribution, static repeating values,
|
|
22
|
input conversion, and many more.
|
|
23
|
|
|
24
|
|
|
25
|
|
|
26
|
REQUIREMENTS
|
|
27
|
------------
|
|
28
|
|
|
29
|
Project in Drupal 7 requires the following modules:
|
|
30
|
|
|
31
|
* Fields API (Fields API is provided already by core)
|
|
32
|
* Panels (https://drupal.org/project/panels)
|
|
33
|
|
|
34
|
Drupal 8:
|
|
35
|
|
|
36
|
* Link is in core now. No installation needed. Yay! Don't forget to activate
|
|
37
|
it. It's deactivated by default.
|
|
38
|
|
|
39
|
|
|
40
|
INSTALLATION
|
|
41
|
------------
|
|
42
|
|
|
43
|
Install as you would normally install a contributed Drupal module. See:
|
|
44
|
https://drupal.org/documentation/install/modules-themes/modules-7 for further
|
|
45
|
information.
|
|
46
|
|
|
47
|
|
|
48
|
CONFIGURATION
|
|
49
|
-------------
|
|
50
|
|
|
51
|
* Configuration is only slightly more complicated than a text field. Link text
|
|
52
|
titles for URLs can be made required, set as instead of URL, optional
|
|
53
|
(default), or left out entirely. If no link text title is provided, the
|
|
54
|
trimmed version of the complete URL will be displayed. The target attribute
|
|
55
|
should be set to "_blank", "top", or left out completely (checkboxes provide
|
|
56
|
info). The rel=nofollow attribute prevents the link from being followed by
|
|
57
|
certain search engines. More info at Wikipedia
|
|
58
|
(http://en.wikipedia.org/wiki/Spam_in_blogs#rel.3D.22nofollow.22).
|
|
59
|
|
|
60
|
|
|
61
|
EXAMPLE
|
|
62
|
-------
|
|
63
|
If you were to create a field named 'My New Link', the default display of the
|
|
64
|
link would be:
|
|
65
|
<em><div class="field_my_new_link" target="[target_value]"><a href="[URL]">
|
|
66
|
[Title]</a></div></em> where items between [] characters would be customized
|
|
67
|
based on the user input.
|
|
68
|
|
|
69
|
The link project supports both, internal and external URLs. URLs are validated
|
|
70
|
on input. Here are some examples of data input and the default view of a link:
|
|
71
|
http://drupal.org results in http://drupal.org, but drupal.org results in
|
|
72
|
http://drupal.org, while <front> will convert into http://drupal.org and
|
|
73
|
node/74971 into http://drupal.org/project/link
|
|
74
|
|
|
75
|
Anchors and query strings may also be used in any of these cases, including:
|
|
76
|
node/74971/edit?destination=node/74972<front>#pager
|
|
77
|
|
|
78
|
|
|
79
|
THEMING AND OUTPUT
|
|
80
|
------------------
|
|
81
|
Since link module is mainly a data storage field in a modular framework, the
|
|
82
|
theming and output is up to the site builder and other additional modules. There
|
|
83
|
are many modules in the Drupal repository, which control the output of fields
|
|
84
|
perfectly and can handle rules, user actions, markup dependencies, and can vary
|
|
85
|
the output under many different conditions, with much more efficience and
|
|
86
|
flexibility for different scenarios. Please check out modules like views,
|
|
87
|
display suite, panels, etc for such needs
|
|
88
|
|
|
89
|
|
|
90
|
MAINTAINERS
|
|
91
|
-----------
|
|
92
|
|
|
93
|
Current maintainers:
|
|
94
|
* John C Fiala (jcfiala) - https://www.drupal.org/user/163643
|
|
95
|
* Renato Gonçalves (RenatoG) - https://www.drupal.org/user/3326031
|
|
96
|
* Clemens Tolboom (clemens.tolboom) - https://www.drupal.org/user/125814
|
|
97
|
* diqidoq - https://www.drupal.org/user/1001934
|
|
98
|
* dropcube - https://www.drupal.org/user/37031
|
|
99
|
* Tom Kirkpatrick (mrfelton) - https://www.drupal.org/user/305669
|
|
100
|
* Sumit Madan (sumitmadan) - https://www.drupal.org/user/1538790
|
|
101
|
* Daniel Kudwien (sun) - https://www.drupal.org/user/54136
|
