You are here

Home » API reference » Hacked! 7.2

README.txt in Hacked! 7.2

Same filename and directory in other branches
  1. 7.3 README.txt
CONTENTS OF THIS FILE
---------------------

* Introduction
* Requirements
* Recommended modules
* Installation
* Configuration
* Drush
* Maintainers


INTRODUCTION
------------

The Hacked! module scans the currently installed Drupal contributed modules and
themes, re-downloads them and determines if they have been changed. Changes are
marked clearly and if the Diff module is installed then Hacked! will allow you
to see the exact lines that have changed.

* For a full description of the module visit
https://www.drupal.org/node/667576

* To submit bug reports and feature suggestions, or to track changes visit
https://www.drupal.org/project/issues/hacked


REQUIREMENTS
------------

This module does not require any additional modules outside of Drupal core.

RECOMMENDED MODULES
-------------------

Diff - https://www.drupal.org/project/diff


INSTALLATION
------------

Option 1:

Install the Hacked! module as you would normally install a contributed Drupal
module, and then enable it.
Visit https://www.drupal.org/docs/7/extend/installing-modules for further
information.

Option 2:

To leave the site untouched, and not install the module, do the following:

1. Outside of the Drupal directory structure, download the Hacked module to your
Drush directory.
    * `drush pm-download hacked`
2. Clear your Drush cache to pick up the new commands.
    * `drush cache-clear drush`


CONFIGURATION
-------------

1. Navigate to Administration > Reports > Hacked. The "List projects" tab will
provide a list of modules which have changes. Each list item provides a "View
details of changes" link which gives a more detailed list of what exact changes
occurred.
The "Settings" tab allows two options: "Ignore line endings" which is helpful if
the project has been edited on a platform different from the original author's
(E.g. if a file has been opened and saved on Windows) and "Include line endings"
when hashing files differences in line endings will be included.
2. To run a report which includes disabled modules, navigate to Administration
> Reports > Updates > Settings and click the "Check for updates of disabled and
uninstalled modules and themes" checkbox. Save configuration.

The process of fetching and comparing with clean projects can be a
time-consuming one, so give it some time to load on the first run.


DRUSH
-----

Drush commands in hacked:

hacked-details (hd)   Show the Hacked! report about a specific project.
hacked-diff           Output a unified diff of the project specified.
hacked-list-projects  List all projects that can be analysed by Hacked!


MAINTAINERS
-----------

* Andrei Ivnitskii - https://www.drupal.org/u/itcrowd72
* Colan Schwartz - https://www.drupal.org/u/colan
* Stuart Clark (Deciphered) - https://www.drupal.org/u/deciphered
* Steven Jones - https://www.drupal.org/u/steven-jones

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. ---------------------

  3. 

  4. * Introduction

  5. * Requirements

  6. * Recommended modules

  7. * Installation

  8. * Configuration

  9. * Drush

  10. * Maintainers

  11. 

  12. 

  13. INTRODUCTION

  14. ------------

  15. 

  16. The Hacked! module scans the currently installed Drupal contributed modules and

  17. themes, re-downloads them and determines if they have been changed. Changes are

  18. marked clearly and if the Diff module is installed then Hacked! will allow you

  19. to see the exact lines that have changed.

  20. 

  21. * For a full description of the module visit

  22. https://www.drupal.org/node/667576

  23. 

  24. * To submit bug reports and feature suggestions, or to track changes visit

  25. https://www.drupal.org/project/issues/hacked

  26. 

  27. 

  28. REQUIREMENTS

  29. ------------

  30. 

  31. This module does not require any additional modules outside of Drupal core.

  32. 

  33. RECOMMENDED MODULES

  34. -------------------

  35. 

  36. Diff - https://www.drupal.org/project/diff

  37. 

  38. 

  39. INSTALLATION

  40. ------------

  41. 

  42. Option 1:

  43. 

  44. Install the Hacked! module as you would normally install a contributed Drupal

  45. module, and then enable it.

  46. Visit https://www.drupal.org/docs/7/extend/installing-modules for further

  47. information.

  48. 

  49. Option 2:

  50. 

  51. To leave the site untouched, and not install the module, do the following:

  52. 

  53. 1. Outside of the Drupal directory structure, download the Hacked module to your

  54. Drush directory.

  55.     * `drush pm-download hacked`

  56. 2. Clear your Drush cache to pick up the new commands.

  57.     * `drush cache-clear drush`

  58. 

  59. 

  60. CONFIGURATION

  61. -------------

  62. 

  63. 1. Navigate to Administration > Reports > Hacked. The "List projects" tab will

  64. provide a list of modules which have changes. Each list item provides a "View

  65. details of changes" link which gives a more detailed list of what exact changes

  66. occurred.

  67. The "Settings" tab allows two options: "Ignore line endings" which is helpful if

  68. the project has been edited on a platform different from the original author's

  69. (E.g. if a file has been opened and saved on Windows) and "Include line endings"

  70. when hashing files differences in line endings will be included.

  71. 2. To run a report which includes disabled modules, navigate to Administration

  72. > Reports > Updates > Settings and click the "Check for updates of disabled and

  73. uninstalled modules and themes" checkbox. Save configuration.

  74. 

  75. The process of fetching and comparing with clean projects can be a

  76. time-consuming one, so give it some time to load on the first run.

  77. 

  78. 

  79. DRUSH

  80. -----

  81. 

  82. Drush commands in hacked:

  83. 

  84. hacked-details (hd)   Show the Hacked! report about a specific project.

  85. hacked-diff           Output a unified diff of the project specified.

  86. hacked-list-projects  List all projects that can be analysed by Hacked!

  87. 

  88. 

  89. MAINTAINERS

  90. -----------

  91. 

  92. * Andrei Ivnitskii - https://www.drupal.org/u/itcrowd72

  93. * Colan Schwartz - https://www.drupal.org/u/colan

  94. * Stuart Clark (Deciphered) - https://www.drupal.org/u/deciphered

  95. * Steven Jones - https://www.drupal.org/u/steven-jones