README.txt 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101
  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. Project in Drupal 7 requires the following modules:
  22. * Fields API (Fields API is provided already by core)
  23. * Panels (https://drupal.org/project/panels)
  24. Drupal 8:
  25. * Link is in core now. No installation needed. Yay! Don't forget to activate
  26. it. It's deactivated by default.
  27. INSTALLATION
  28. ------------
  29. Install as you would normally install a contributed Drupal module. See:
  30. https://drupal.org/documentation/install/modules-themes/modules-7 for further
  31. information.
  32. CONFIGURATION
  33. -------------
  34. * Configuration is only slightly more complicated than a text field. Link text
  35. titles for URLs can be made required, set as instead of URL, optional
  36. (default), or left out entirely. If no link text title is provided, the
  37. trimmed version of the complete URL will be displayed. The target attribute
  38. should be set to "_blank", "top", or left out completely (checkboxes provide
  39. info). The rel=nofollow attribute prevents the link from being followed by
  40. certain search engines. More info at Wikipedia
  41. (http://en.wikipedia.org/wiki/Spam_in_blogs#rel.3D.22nofollow.22).
  42. EXAMPLE
  43. -------
  44. If you were to create a field named 'My New Link', the default display of the
  45. link would be:
  46. <em><div class="field_my_new_link" target="[target_value]"><a href="[URL]">
  47. [Title]</a></div></em> where items between [] characters would be customized
  48. based on the user input.
  49. The link project supports both, internal and external URLs. URLs are validated
  50. on input. Here are some examples of data input and the default view of a link:
  51. http://drupal.org results in http://drupal.org, but drupal.org results in
  52. http://drupal.org, while <front> will convert into http://drupal.org and
  53. node/74971 into http://drupal.org/project/link
  54. Anchors and query strings may also be used in any of these cases, including:
  55. node/74971/edit?destination=node/74972<front>#pager
  56. THEMING AND OUTPUT
  57. ------------------
  58. Since link module is mainly a data storage field in a modular framework, the
  59. theming and output is up to the site builder and other additional modules. There
  60. are many modules in the Drupal repository, which control the output of fields
  61. perfectly and can handle rules, user actions, markup dependencies, and can vary
  62. the output under many different conditions, with much more efficience and
  63. flexibility for different scenarios. Please check out modules like views,
  64. display suite, panels, etc for such needs
  65. MAINTAINERS
  66. -----------
  67. Current maintainers:
  68. * John C Fiala (jcfiala) - https://www.drupal.org/user/163643
  69. * Renato Gonçalves (RenatoG) - https://www.drupal.org/user/3326031
  70. * Clemens Tolboom (clemens.tolboom) - https://www.drupal.org/user/125814
  71. * diqidoq - https://www.drupal.org/user/1001934
  72. * dropcube - https://www.drupal.org/user/37031
  73. * Tom Kirkpatrick (mrfelton) - https://www.drupal.org/user/305669
  74. * Sumit Madan (sumitmadan) - https://www.drupal.org/user/1538790
  75. * Daniel Kudwien (sun) - https://www.drupal.org/user/54136