Projet

Général

Profil

Paste
Télécharger (7,23 ko) Statistiques
| Branche: | Révision:

root / drupal7 / sites / all / themes / bootstrap / docs / FAQ.md @ 7547bb19

1
<!-- @file Frequently Asked Questions -->
2
<!-- @defgroup -->
3
# FAQ - Frequently Asked Questions
4

    
5
- [Do you support X module?](#support)
6
- [Do you support Internet Explorer?](#ie)
7
- [Is Drupal Bootstrap a module or theme?](#module-or-theme)
8
- [What does the JavaScript error `TypeError: $(...).on is not a function` mean?](#jquery)
9
- [Where can I discuss an issue in real time?](#irc)
10
- [Where should I make changes?](#changes)
11
- [Why are my sub-theme's `.info` settings ignored?](#theme-settings-ignored)
12

    
13
---
14

    
15
### Q: Do you support X module? {#support}
16
**A: Possibly**
17

    
18
Below are a list of modules the [Drupal Bootstrap] base theme actively supports.
19
This list is constantly growing and each module's support has usually been
20
implemented because of either extremely high usage or the fact it was designed
21
explicitly for use with this base theme and has maintainers in both projects.
22

    
23
**Supported modules:**
24
- [Admin Menu](https://www.drupal.org/project/admin_menu)
25
- [Bootstrap Core](https://www.drupal.org/project/bootstrap_core)
26
- [Disable Messages](https://www.drupal.org/project/disable_messages)
27
- [jQuery Update](https://www.drupal.org/project/jquery_update)
28
- [Icon API](https://www.drupal.org/project/icon)
29
- [Path Breadcrumbs](https://www.drupal.org/project/path_breadcrumbs)
30
- [Picture](https://www.drupal.org/project/picture)
31
- [Views](https://www.drupal.org/project/picture) _(partial support)_
32
- [Webform](https://www.drupal.org/project/webform) _(partial support)_
33

    
34
The following modules are "un-supported modules" and are not documented by the
35
[Drupal Bootstrap] base theme. This does not mean that the base theme will not
36
work with them or that they are "bad". It simply means that this project does
37
not have the time, energy or effort it would take to document "every possible
38
scenario".
39

    
40
It is certainly possible that some of these modules may eventually become
41
"officially" supported. That will happen only, of course, if there are enough
42
people to help contribute solid solutions and make supporting them by the base
43
theme maintainers a relatively "easy" task.
44

    
45
Some of these modules may have blogs or videos floating around on the internet.
46
However, if you choose to use one of these modules, you are really doing so
47
at your own expense. Do not expect support from this base theme or the project
48
you are attempting to integrate the base theme with.
49

    
50
**"Un-supported" modules:**
51
- Color module (in core)
52
- [Bootstrap API](https://www.drupal.org/project/bootstrap_api)
53
- [Bootstrap Library](https://www.drupal.org/project/bootstrap_library)
54
- [Display Suite](https://www.drupal.org/project/ds)
55
- [Display Suite Bootstrap Layouts](https://www.drupal.org/project/ds_bootstrap_layouts)
56
- [LESS module](https://drupal.org/project/less)
57
- [Panels](https://www.drupal.org/project/panels)
58
- [Panels Bootstrap Layouts](https://www.drupal.org/project/panels_bootstrap_layouts)
59

    
60
---
61

    
62
### Q: Do you support Internet Explorer? {#ie}
63
**A: No, not "officially"**
64

    
65
The [Bootstrap Framework] itself does not officially support older Internet
66
Explorer [compatibility modes](http://getbootstrap.com/getting-started/#support-ie-compatibility-modes).
67
To ensure you are using the latest rendering mode for IE, consider installing
68
the [HTML5 Tools](https://drupal.org/project/html5_tools) module.
69

    
70
Internet Explorer 8 requires the use of [Respond.js] to enable media queries
71
(Responsive Web Design). However, [Respond.js] does not work with CSS that is
72
referenced via a CSS `@import` statement, which is the default way Drupal
73
adds CSS files to a page when CSS aggregation is disabled. To ensure
74
[Respond.js] works properly, enable CSS aggregation at the bottom of:
75
`admin/config/development/performance`.
76

    
77
---
78

    
79
### Q: Is Drupal Bootstrap a module or theme? {#module-or-theme}
80
**A: Theme**
81

    
82
More specifically a base theme. It is _not_ a module. Modules are allowed to
83
participate in certain hooks, while themes cannot. This is a very important
84
concept to understand and limits themes from participating in a wider range of
85
functionality.
86

    
87
---
88

    
89
### Q: What does the JavaScript error `TypeError: $(...).on is not a function` mean? {#jquery}
90
Drupal 7 ships with the `1.4.4` version of jQuery out-of-the-box. The [$.on()](http://api.jquery.com/on/)
91
method was introduced several versions after this in jQuery version `1.7`.
92

    
93
You must upgrade your site or sub-theme's jQuery Version by installing (and
94
properly configuring) the [jQuery Update] module to use a jQuery version
95
compatible with the [Bootstrap Framework]. This is typically a version greater
96
than or equal to `1.9`.
97

    
98
Ensuring jQuery compatibilities between Drupal, the [Bootstrap Framework] and
99
other plugins/modules does not fall within the scope of this base theme's
100
documentation or support.
101

    
102
---
103

    
104
### Q: Where can I discuss an issue in real time? {#irc}
105
**A: In IRC**
106

    
107
The [Drupal Bootstrap] project and its maintainers use the `#drupal-bootstrap`
108
channel on the freenode.net IRC network to communicate in real time. Please read
109
the following for more information on how to the community uses this technology:
110
[Chat with the Drupal Community on IRC](https://www.drupal.org/irc).
111

    
112
Please keep in mind though, this **IS NOT** a "support" channel. It's primary
113
use is to discuss issues and to help fix bugs with the base theme itself.
114

    
115
---
116

    
117
### Q: Where should I make changes? {#changes}
118
**A: In a custom sub-theme**
119

    
120
You should **never** modify any theme or sub-theme that is packaged and released
121
from Drupal.org. If you do, all changes you have made would be lost once that
122
theme is updated. This makes keeping track of changes next to impossible.
123

    
124
Instead, you should create a custom sub-theme that isn't hosted on Drupal.org.
125

    
126
[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
127
[Bootstrap Framework]: http://getbootstrap.com
128
[Respond.js]: https://github.com/scottjehl/Respond
129

    
130
---
131

    
132
### Q: Why are my sub-theme's `.info` settings ignored? {#theme-settings-ignored}
133
**A: The database contains a copy of the theme settings and they take
134
precedence over theme settings stored in the `.info` file.**
135

    
136
This is actually quite a common issue whenever a theme's settings are saved
137
from the UI. This action stores the settings in the {variables} table of the
138
database. The workflow for theme_get_setting() merges the settings from the
139
database on top of the settings found in the theme's `.info` file.
140

    
141
You need to remove the variable `theme_[theme_name]_settings` from the database,
142
where `[theme_name]` is your sub-theme's machine name (e.g. if your sub-theme
143
machine name is `my_bootstrap_subtheme`, the variable name would be
144
`theme_my_bootstrap_subtheme_settings`).
145

    
146
The easiest way to do accomplish this task is to use the following [Drush]
147
command: `theme_my_bootstrap_subtheme_settings`
148

    
149
If you do not have or use [Drush], you will either have to manually delete this
150
variable from the database or create an [update hook](https://api.drupal.org/api/drupal/modules%21system%21system.api.php/function/hook_update_N/7)
151
in a custom module that deletes the variable for you:
152

    
153
```php
154
/**
155
* Remove the 'theme_my_bootstrap_subtheme_settings' variable.
156
*/
157
function hook_update_N() {
158
  variable_del('theme_my_bootstrap_subtheme_settings');
159
}
160
```
161

    
162
[Drush]: http://www.drush.org
163
[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
164
[Bootstrap Framework]: http://getbootstrap.com
165
[jQuery Update]: https://drupal.org/project/jquery_update