|
Chris@0
|
1
|
|
Chris@0
|
2 CONTENTS OF THIS FILE
|
|
Chris@0
|
3 ---------------------
|
|
Chris@0
|
4
|
|
Chris@0
|
5 * About Drupal
|
|
Chris@0
|
6 * Configuration and features
|
|
Chris@0
|
7 * Installation profiles
|
|
Chris@0
|
8 * Appearance
|
|
Chris@0
|
9 * Developing for Drupal
|
|
Chris@0
|
10 * More information
|
|
Chris@0
|
11
|
|
Chris@0
|
12 ABOUT DRUPAL
|
|
Chris@0
|
13 ------------
|
|
Chris@0
|
14
|
|
Chris@0
|
15 Drupal is an open source content management platform supporting a variety of
|
|
Chris@0
|
16 websites ranging from personal weblogs to large community-driven websites. For
|
|
Chris@0
|
17 more information, see the Drupal website at https://www.drupal.org, and join
|
|
Chris@0
|
18 the Drupal community at https://www.drupal.org/community.
|
|
Chris@0
|
19
|
|
Chris@0
|
20 Legal information about Drupal:
|
|
Chris@0
|
21 * Know your rights when using Drupal:
|
|
Chris@0
|
22 See LICENSE.txt in the "core" directory.
|
|
Chris@0
|
23 * Learn about the Drupal trademark and logo policy:
|
|
Chris@0
|
24 https://www.drupal.com/trademark
|
|
Chris@0
|
25
|
|
Chris@0
|
26 CONFIGURATION AND FEATURES
|
|
Chris@0
|
27 --------------------------
|
|
Chris@0
|
28
|
|
Chris@0
|
29 Drupal core (what you get when you download and extract a drupal-x.y.tar.gz or
|
|
Chris@0
|
30 drupal-x.y.zip file from https://www.drupal.org/project/drupal) has what you
|
|
Chris@0
|
31 need to get started with your website. It includes several modules (extensions
|
|
Chris@0
|
32 that add functionality) for common website features, such as managing content,
|
|
Chris@0
|
33 user accounts, image uploading, and search. Core comes with many options that
|
|
Chris@0
|
34 allow site-specific configuration. In addition to the core modules, there are
|
|
Chris@0
|
35 thousands of contributed modules (for functionality not included with Drupal
|
|
Chris@0
|
36 core) available for download.
|
|
Chris@0
|
37
|
|
Chris@0
|
38 More about configuration:
|
|
Chris@0
|
39 * Install, update, and maintain Drupal:
|
|
Chris@0
|
40 See INSTALL.txt and UPDATE.txt in the "core" directory.
|
|
Chris@0
|
41 * Learn about how to use Drupal to create your site:
|
|
Chris@0
|
42 https://www.drupal.org/documentation
|
|
Chris@0
|
43 * Follow best practices:
|
|
Chris@0
|
44 https://www.drupal.org/best-practices
|
|
Chris@0
|
45 * Download contributed modules to /modules to extend Drupal's functionality:
|
|
Chris@0
|
46 https://www.drupal.org/project/modules
|
|
Chris@0
|
47 * See also: "Developing for Drupal" for writing your own modules, below.
|
|
Chris@0
|
48
|
|
Chris@0
|
49
|
|
Chris@0
|
50 INSTALLATION PROFILES
|
|
Chris@0
|
51 ---------------------
|
|
Chris@0
|
52
|
|
Chris@0
|
53 Installation profiles define additional steps (such as enabling modules,
|
|
Chris@0
|
54 defining content types, etc.) that run after the base installation provided
|
|
Chris@0
|
55 by core when Drupal is first installed. There are two basic installation
|
|
Chris@0
|
56 profiles provided with Drupal core.
|
|
Chris@0
|
57
|
|
Chris@0
|
58 Installation profiles from the Drupal community modify the installation process
|
|
Chris@0
|
59 to provide a website for a specific use case, such as a CMS for media
|
|
Chris@0
|
60 publishers, a web-based project tracking tool, or a full-fledged CRM for
|
|
Chris@0
|
61 non-profit organizations raising money and accepting donations. They can be
|
|
Chris@0
|
62 distributed as bare installation profiles or as "distributions". Distributions
|
|
Chris@0
|
63 include Drupal core, the installation profile, and all other required
|
|
Chris@0
|
64 extensions, such as contributed and custom modules, themes, and third-party
|
|
Chris@0
|
65 libraries. Bare installation profiles require you to download Drupal Core and
|
|
Chris@0
|
66 the required extensions separately; place the downloaded profile in the
|
|
Chris@0
|
67 /profiles directory before you start the installation process.
|
|
Chris@0
|
68
|
|
Chris@0
|
69 More about installation profiles and distributions:
|
|
Chris@0
|
70 * Read about the difference between installation profiles and distributions:
|
|
Chris@0
|
71 https://www.drupal.org/node/1089736
|
|
Chris@0
|
72 * Download contributed installation profiles and distributions:
|
|
Chris@0
|
73 https://www.drupal.org/project/distributions
|
|
Chris@0
|
74 * Develop your own installation profile or distribution:
|
|
Chris@0
|
75 https://www.drupal.org/developing/distributions
|
|
Chris@0
|
76
|
|
Chris@0
|
77
|
|
Chris@0
|
78 APPEARANCE
|
|
Chris@0
|
79 ----------
|
|
Chris@0
|
80
|
|
Chris@0
|
81 In Drupal, the appearance of your site is set by the theme (themes are
|
|
Chris@0
|
82 extensions that set fonts, colors, and layout). Drupal core comes with several
|
|
Chris@0
|
83 themes. More themes are available for download, and you can also create your own
|
|
Chris@0
|
84 custom theme.
|
|
Chris@0
|
85
|
|
Chris@0
|
86 More about themes:
|
|
Chris@0
|
87 * Download contributed themes to /themes to modify Drupal's appearance:
|
|
Chris@0
|
88 https://www.drupal.org/project/themes
|
|
Chris@0
|
89 * Develop your own theme:
|
|
Chris@0
|
90 https://www.drupal.org/documentation/theme
|
|
Chris@0
|
91
|
|
Chris@0
|
92 DEVELOPING FOR DRUPAL
|
|
Chris@0
|
93 ---------------------
|
|
Chris@0
|
94
|
|
Chris@0
|
95 Drupal contains an extensive API that allows you to add to and modify the
|
|
Chris@0
|
96 functionality of your site. The API consists of "hooks", which allow modules to
|
|
Chris@0
|
97 react to system events and customize Drupal's behavior, and functions that
|
|
Chris@0
|
98 standardize common operations such as database queries and form generation. The
|
|
Chris@0
|
99 flexible hook architecture means that you should never need to directly modify
|
|
Chris@0
|
100 the files that come with Drupal core to achieve the functionality you want;
|
|
Chris@0
|
101 instead, functionality modifications take the form of modules.
|
|
Chris@0
|
102
|
|
Chris@0
|
103 When you need new functionality for your Drupal site, search for existing
|
|
Chris@0
|
104 contributed modules. If you find a module that matches except for a bug or an
|
|
Chris@0
|
105 additional needed feature, change the module and contribute your improvements
|
|
Chris@0
|
106 back to the project in the form of a "patch". Create new custom modules only
|
|
Chris@0
|
107 when nothing existing comes close to what you need.
|
|
Chris@0
|
108
|
|
Chris@0
|
109 More about developing:
|
|
Chris@0
|
110 * Search for existing contributed modules:
|
|
Chris@0
|
111 https://www.drupal.org/project/modules
|
|
Chris@0
|
112 * Contribute a patch:
|
|
Chris@0
|
113 https://www.drupal.org/patch/submit
|
|
Chris@0
|
114 * Develop your own module:
|
|
Chris@0
|
115 https://www.drupal.org/developing/modules
|
|
Chris@0
|
116 * Follow programming best practices:
|
|
Chris@0
|
117 https://www.drupal.org/developing/best-practices
|
|
Chris@0
|
118 * Refer to the API documentation:
|
|
Chris@0
|
119 https://api.drupal.org/api/drupal/8
|
|
Chris@0
|
120 * Learn from documented Drupal API examples:
|
|
Chris@0
|
121 https://www.drupal.org/project/examples
|
|
Chris@0
|
122
|
|
Chris@0
|
123 MORE INFORMATION
|
|
Chris@0
|
124 ----------------
|
|
Chris@0
|
125
|
|
Chris@0
|
126 * See the Drupal.org online documentation:
|
|
Chris@0
|
127 https://www.drupal.org/documentation
|
|
Chris@0
|
128
|
|
Chris@0
|
129 * For a list of security announcements, see the "Security advisories" page at
|
|
Chris@0
|
130 https://www.drupal.org/security (available as an RSS feed). This page also
|
|
Chris@0
|
131 describes how to subscribe to these announcements via email.
|
|
Chris@0
|
132
|
|
Chris@0
|
133 * For information about the Drupal security process, or to find out how to
|
|
Chris@0
|
134 report a potential security issue to the Drupal security team, see the
|
|
Chris@0
|
135 "Security team" page at https://www.drupal.org/security-team
|
|
Chris@0
|
136
|
|
Chris@0
|
137 * For information about the wide range of available support options, visit
|
|
Chris@0
|
138 https://www.drupal.org and click on Community and Support in the top or
|
|
Chris@0
|
139 bottom navigation.
|
