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 @ 87dbc3bf

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