README.txt 3.3 KB

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