Projet

Général

Profil

Paste
Télécharger (4,53 ko) Statistiques
| Branche: | Révision:

root / drupal7 / sites / all / themes / adaptivetheme / at_core / _README.txt @ fbb05e21

1 85ad3d82 Assos Assos
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