Projet

Général

Profil

Révision 39a181a4

Ajouté par Assos Assos il y a environ 6 ans

Weekly update of contrib modules

Voir les différences:

drupal7/sites/all/modules/link/README.txt
1 
Module description
2 
------------------
3 
The link module can be count to the top 50 modules 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.
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:


  		




  4
  30
  
    

  		




  5
  
  
    
Requirements / Dependencies


  		




  6
  
  
    
---------------------------


  		




  7
  
  
    
1. Drupal 6: Custom content module (CCK)


  		




  8
  
  
    
2. Drupal 7: Fields API is provided already by core [no dependencies].


  		




  9
  
  
    
3. Drupal 8: Link module is in core now. No module installation needed. Yay! Don't forget to activate it. It's deactivated by default.


  		




  
  31
  
    
 * Fields API (Fields API is provided already by core)


  		




  
  32
  
    
 * Panels (https://drupal.org/project/panels)


  		




  10
  33
  
    

  		




  11
  
  
    
INFO Since some misleading user reports we need to clarify here - Link module is NOT about to add links to any menus or the navigation nor primary/secondary menu. This can be done with default menu module (part of Drupal core). The Link module provides an additional custom field for storing and validating links to be added with any content type, which means another input block additional to your text-body, title, image and any other input you can make on new content creation.


  		




  
  34
  
    
Drupal 8:


  		




  12
  35
  
    

  		




  13
  
  
    
Installation


  		




  
  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


  		




  14
  41
  
    
------------


  		




  15
  
  
    
1. Drop the entire link module directory into your 'sites/all/modules' folder


  		




  16
  
  
    
2. Enable the module from the Administration area modules page (admin/build/modules)


  		




  17
  
  
    
3. Create or Edit a content-type and add a new field of type link (admin/content/types in D6, admin/structure/types in D7)


  		




  18
  42
  
    

  		




  19
  
  
    
Configuration


  		




  
  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


  		




  20
  49
  
    
-------------


  		




  21
  
  
    
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).


  		




  22
  50
  
    

  		




  23
  
  
    
Example


  		




  
  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


  		




  24
  62
  
    
-------


  		




  25
  
  
    
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.


  		




  
  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


  		




  26
  74
  
    

  		




  27
  
  
    
The link module 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


  		




  
  75
  
    
Anchors and query strings may also be used in any of these cases, including:


  		




  
  76
  
    
node/74971/edit?destination=node/74972<front>#pager


  		




  28
  77
  
    

  		




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


  		




  30
  78
  
    

  		




  31
  
  
    
Theming and Output


  		




  
  79
  
    
THEMING AND OUTPUT


  		




  32
  80
  
    
------------------


  		




  33
  
  
    
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.


  		




  
  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


  		












Formats disponibles :  Unified diff