1
|
|
2
|
|
3
|
Basic Info
|
4
|
----------
|
5
|
|
6
|
The base theme provides many resources to all subthemes including templates,
|
7
|
layout CSS, base CSS helper, template overrides, function overrides and theme
|
8
|
settings. You should not edit this theme - its only job is to provide resources
|
9
|
to subthemes.
|
10
|
|
11
|
|
12
|
|
13
|
Templates and Theme Functions
|
14
|
-----------------------------
|
15
|
|
16
|
All templates are in:
|
17
|
|
18
|
~/at_core/templates/
|
19
|
|
20
|
If you need to modify a template OR theme function for your subtheme copy and
|
21
|
paste the template or function into your subtheme and clear your sites cache.
|
22
|
|
23
|
Its worth reviewing many of the templates - especially block and region tpl files
|
24
|
because these are quite different to Drupal cores templates and use preprocess
|
25
|
and process functions to build most of the markup.
|
26
|
|
27
|
All theme function overrides are in:
|
28
|
|
29
|
~/at_core/inc/theme.inc
|
30
|
|
31
|
|
32
|
|
33
|
Preprocess and Process Functions
|
34
|
--------------------------------
|
35
|
|
36
|
AT Core makes heavy use of these functions, they can be found respectively in:
|
37
|
|
38
|
~/at_core/inc/preprocess.inc
|
39
|
~/at_core/inc/process.inc
|
40
|
|
41
|
|
42
|
|
43
|
Alters
|
44
|
------
|
45
|
|
46
|
Drupal 7 allows themes to run many alters, AT Core takes advantage of this, see:
|
47
|
|
48
|
~/at_core/inc/alters.inc
|
49
|
|
50
|
|
51
|
|
52
|
Layout System
|
53
|
-------------
|
54
|
|
55
|
Adaptivetheme uses a pluggable layout. There are two types of layout plugins:
|
56
|
|
57
|
- AT Core Page Layout plugins
|
58
|
- Panels plugins
|
59
|
|
60
|
Both are responsive and can be configured via the theme settings on your themes
|
61
|
appearace configuration page.
|
62
|
|
63
|
You can define new layout plugins in your subtheme - please the info file in
|
64
|
adaptivetheme_subtheme and detailed docs on how to build plugins in the
|
65
|
following files:
|
66
|
|
67
|
page layouts: at_core/layouts/core/the three_col_grail/the three_col_grail.inc
|
68
|
|
69
|
panels: at_core/layouts/panels/five_5x20/five_5x20.inc
|
70
|
|
71
|
|
72
|
|
73
|
Gpanels
|
74
|
-------
|
75
|
|
76
|
Gpanels are multi-column layout snippets for displaying blocks in vertical columns
|
77
|
that you can drop into your subtheme. For example you may want a 4 column footer,
|
78
|
or a 3 column panel above your main content. Gpanels makes this as easy as copy
|
79
|
and paste.
|
80
|
|
81
|
See the README in the gpanels directory for instructions.
|
82
|
|
83
|
NOTE: Gpanels use the exact same markup and CSS as the Panels module plugins, so
|
84
|
they will respond to the same theme settings you set for Panels. See below.
|
85
|
|
86
|
|
87
|
|
88
|
Panels module
|
89
|
-------------
|
90
|
|
91
|
Like all Gpanels the Panels module layouts are all responsive - simply enable
|
92
|
this theme, go to Panels and start building your pages.
|
93
|
|
94
|
All the Panels layouts will load automatically inside Panels - they are called
|
95
|
AT Responsive Panels. Only AT Responsive Panels are responsive, the normal
|
96
|
Panels layout or other panels layouts may not be and will not respond.
|
97
|
|
98
|
To set alternative layouts for each mobile device group goto the theme settings
|
99
|
for your theme and configure them under the "Gpanels and Panels" tab.
|
100
|
|
101
|
NOTE: if you do not have Panels installed you will not see anything to configure,
|
102
|
unless your theme has some Gpanels - AT Core detects if Panels module is enabled
|
103
|
and what Gpanels are being used by your sub-theme and only shows you the options
|
104
|
for what you are actually using in your theme/site.
|
105
|
|
106
|
|
107
|
|
108
|
|
109
|
Theme Settings
|
110
|
--------------
|
111
|
|
112
|
The base theme provides the core layout settings that provide support for
|
113
|
mobile devices and standard desktop and laptop layouts.
|
114
|
|
115
|
Additionally you will find many settings for Polyfills, Mobile metatags, CSS and
|
116
|
helpful debugging features.
|
117
|
|
118
|
You do not need to add these to your subtheme - it will inherit them
|
119
|
automatically from the base theme.
|
120
|
|
121
|
|
122
|
|
123
|
Extensions
|
124
|
----------
|
125
|
|
126
|
Adaptivetheme ships with many hidden options and features - these are tucked
|
127
|
away in a group of settings called "Extensions". To enable these extensions see:
|
128
|
|
129
|
- Layout & General Settings > Extensions
|
130
|
|
131
|
There are additional features and options for Fonts, Heading and title styles,
|
132
|
Image alignment and captions, breadcrumbs, login block setting, Apple touch
|
133
|
icons, many options for overrideing markup and even a way to enable a
|
134
|
page.tpl.php template that uses 100% width wrappers for designs that need this.
|
135
|
|
136
|
Additionally there is an extension that allows end users to paste in CSS - you
|
137
|
don't need to create an entire sub-theme to make small changes.
|
138
|
|
139
|
|
140
|
|
141
|
|
142
|
CSS Classes
|
143
|
-----------
|
144
|
|
145
|
Adaptivetheme removes many standard CSS classes from the Drupals output - we do
|
146
|
this to clean up the markup because most times these classes are never used. You
|
147
|
can add these back (and additional useful classes) using the theme settings for
|
148
|
CSS classes. You must enable "Extensions" first to do this.
|
149
|
|
150
|
Any problems please post an issue in the Adaptivethemes issue queue on Drupal.org:
|
151
|
http://drupal.org/project/issues/adaptivetheme
|
152
|
|
153
|
aintainer:
|
154
|
* Jeff Burnz http://drupal.org/user/61393
|
155
|
|
156
|
|
157
|
|
158
|
|