From 31f16e74c33c87205677c6a3168d5ee0f1aabeeb Mon Sep 17 00:00:00 2001
From: Dries Buytaert <dries@buytaert.net>
Date: Fri, 30 Apr 2010 08:09:21 +0000
Subject: [PATCH] - Patch #569042 by nenne, jhodgdon: INSTALL.txt should
explain about where to put new modules/themes.
---
INSTALL.txt | 45 +++++++++++++++++++++++++--------------------
1 file changed, 25 insertions(+), 20 deletions(-)
diff --git a/INSTALL.txt b/INSTALL.txt
index 5e1c4a638219..86b1a7fbf594 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -266,35 +266,40 @@ INSTALLATION
customized similar to the above example, to add your site-specific cron key
and domain name.)
-DRUPAL ADMINISTRATION
----------------------
+
+BUILDING AND CUSTOMIZING YOUR SITE
+----------------------------------
A new installation of Drupal defaults to a very basic configuration with only a
-few active modules and minimal user access rights.
+few active modules and minimal user access rights. When extending your site,
+you use "modules" and "themes". A module is a plugin that adds functionallity to
+Drupal, while a theme changes the front-end look and behavior of your site.
+
+It is important to install these correctly and not mix them in with the core
+Drupal module and theme set (directories modules and themes at the top level).
+So normally you place them under the following paths:
-Use your administration panel to enable and configure services. For example:
+Modules:
+ sites/all/modules/example_module
-General Settings Administer > Site configuration > Site information
-Enable Modules Administer > Structure > Modules
-Configure Themes Administer > Structure > Themes
-Set User Permissions Administer > User management > Permissions
+Themes:
+ sites/all/themes/example_theme
-For more information on configuration options, read the instructions which
-accompany the different configuration settings and consult the various help
-pages available in the administration panel.
+If you run a multisite installation you will want to do this a bit differently.
+You can read more about that on the multisite part of this file.
-Community-contributed modules and themes are available at http://drupal.org/.
+Contributed modules can be found at:
+http://drupal.org/project/Modules
-CUSTOMIZING YOUR THEME(S)
--------------------------
+Contributed themes can be found at:
+http://drupal.org/project/Themes
-Now that your installation is running, you will want to customize the look of
-your site. Several sample themes are included and more can be downloaded from
-drupal.org.
+Later on you might want to write your own code, but remember to NEVER modify the
+core modules and themes in Drupal directories modules and themes. Instead use
+the hooks available in the Drupal API. You can read more about the Drupal API
+and how to develop modules at
+http://drupal.org/developing/modules
-Simple customization of your theme can be done using only CSS. Further changes
-require understanding the phptemplate engine that is part of Drupal. See
-http://drupal.org/handbook/customization to find out more.
MULTISITE CONFIGURATION
-----------------------
--
GitLab