You are here

README.txt in Freelinking 7.3

CONTENTS OF THIS FILE

* Introduction
* Recommended modules
* Installation
* Configuration
* Maintainers

INTRODUCTION

Freelinking implements a filter for the easier creation of HTML links
to other pages in the site or external sites with a wiki style format
such as `[[indicator:identifier]]`.

For example: `[[nodetitle:Page One]]` becomes:

    <a href="/node/1" title="Click to view a local node."
    class="freelink freelink-nodetitle freelink-internal">Page One</a>

Note that there must be no space after the colon after the indicator.

A number of ready-to-use filters are included in the Freelinking
framework (e.g. Nodetitle. Nid, User, Google search, Drupal search,
Drupal projects, Wikipedia, etc.).

There is a framework that allow developers to add new plugins. See the
help file “Creating plugins for Freelinking ver. 3” (available when
you enable Advanced help[1]) for instructions regarding how to add new
plugin.

REQUIREMENTS

* Advanced help hint[1]:
  Will link standard help text to online help and advanced help.

RECOMMENDED MODULES

* Advanced help[2]:
  When this module is enabled the administrator will have access to
  more extensive help.

INSTALLATION

1. Install as you would normally install a contributed drupal
   module. See: Installing modules[3] for further information.
2. Go to Administration » Configuration » Text Formats and activate
   the Freelinking filter for the text formats you want to
   facilitate freelinking for (e.g. Filtered HTML and Full HTML).
3. If you plan to use freelinking for External links, deactivate the
   “Convert URLs into links” filter for the same text formats.
4. Configure the module at Administration » Configuration » Content
   authoring » Freelinking settings.  See next section for details.
5. Clean the cache.

CONFIGURATION

To configure the module, navigate to Administration » Configuration »
Content authoring » Freelinking settings.

The first setting is a pull-down menu to let you set the default
indicator to use when no indicator is specified.  “Nodetitle” mimics
previous versions of Freelinking.

The global options and options to increase performance are global, and
apply to all plugins. Please see the description of each checkbox to
determine what each does.

The rest of the configuration pages are for plugin-specific options.

If you change the configiration, remember to press Save
configuration to make the changes effective.

MAINTAINERS

* eafarris - https://www.drupal.org/user/812 (original creator)
* grayside - https://www.drupal.org/u/grayside
* juampy - https://www.drupal.org/u/juampy
* gisle - https://www.drupal.org/u/gisle (current maintainer)

Any help with development (patches, reviews, comments) are welcome.


[1]: https://www.drupal.org/project/advanced_help_hint
[2]: https://www.drupal.org/project/advanced_help
[3]: https://www.drupal.org/documentation/install/modules-themes/modules-7

File

README.txt
View source
  1. CONTENTS OF THIS FILE
  2. * Introduction
  3. * Recommended modules
  4. * Installation
  5. * Configuration
  6. * Maintainers
  7. INTRODUCTION
  8. Freelinking implements a filter for the easier creation of HTML links
  9. to other pages in the site or external sites with a wiki style format
  10. such as `[[indicator:identifier]]`.
  11. For example: `[[nodetitle:Page One]]` becomes:
  12. class="freelink freelink-nodetitle freelink-internal">Page One
  13. Note that there must be no space after the colon after the indicator.
  14. A number of ready-to-use filters are included in the Freelinking
  15. framework (e.g. Nodetitle. Nid, User, Google search, Drupal search,
  16. Drupal projects, Wikipedia, etc.).
  17. There is a framework that allow developers to add new plugins. See the
  18. help file “Creating plugins for Freelinking ver. 3” (available when
  19. you enable Advanced help[1]) for instructions regarding how to add new
  20. plugin.
  21. REQUIREMENTS
  22. * Advanced help hint[1]:
  23. Will link standard help text to online help and advanced help.
  24. RECOMMENDED MODULES
  25. * Advanced help[2]:
  26. When this module is enabled the administrator will have access to
  27. more extensive help.
  28. INSTALLATION
  29. 1. Install as you would normally install a contributed drupal
  30. module. See: Installing modules[3] for further information.
  31. 2. Go to Administration » Configuration » Text Formats and activate
  32. the Freelinking filter for the text formats you want to
  33. facilitate freelinking for (e.g. Filtered HTML and Full HTML).
  34. 3. If you plan to use freelinking for External links, deactivate the
  35. “Convert URLs into links” filter for the same text formats.
  36. 4. Configure the module at Administration » Configuration » Content
  37. authoring » Freelinking settings. See next section for details.
  38. 5. Clean the cache.
  39. CONFIGURATION
  40. To configure the module, navigate to Administration » Configuration »
  41. Content authoring » Freelinking settings.
  42. The first setting is a pull-down menu to let you set the default
  43. indicator to use when no indicator is specified. “Nodetitle” mimics
  44. previous versions of Freelinking.
  45. The global options and options to increase performance are global, and
  46. apply to all plugins. Please see the description of each checkbox to
  47. determine what each does.
  48. The rest of the configuration pages are for plugin-specific options.
  49. If you change the configiration, remember to press Save
  50. configuration to make the changes effective.
  51. MAINTAINERS
  52. * eafarris - https://www.drupal.org/user/812 (original creator)
  53. * grayside - https://www.drupal.org/u/grayside
  54. * juampy - https://www.drupal.org/u/juampy
  55. * gisle - https://www.drupal.org/u/gisle (current maintainer)
  56. Any help with development (patches, reviews, comments) are welcome.
  57. [1]: https://www.drupal.org/project/advanced_help_hint
  58. [2]: https://www.drupal.org/project/advanced_help
  59. [3]: https://www.drupal.org/documentation/install/modules-themes/modules-7