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
|
- [jQuery Update](https://www.drupal.org/project/jquery_update)
|
27
|
- [Icon API](https://www.drupal.org/project/icon)
|
28
|
- [Picture](https://www.drupal.org/project/picture)
|
29
|
- [Views](https://www.drupal.org/project/picture) _(partial support)_
|
30
|
- [Webform](https://www.drupal.org/project/webform) _(partial support)_
|
31
|
|
32
|
The following modules are "un-supported modules" and are not documented by the
|
33
|
[Drupal Bootstrap] base theme. This does not mean that the base theme will not
|
34
|
work with them or that they are "bad". It simply means that this project does
|
35
|
not have the time, energy or effort it would take to document "every possible
|
36
|
scenario".
|
37
|
|
38
|
It is certainly possible that some of these modules may eventually become
|
39
|
"officially" supported. That will happen only, of course, if there are enough
|
40
|
people to help contribute solid solutions and make supporting them by the base
|
41
|
theme maintainers a relatively "easy" task.
|
42
|
|
43
|
Some of these modules may have blogs or videos floating around on the internet.
|
44
|
However, if you choose to use one of these modules, you are really doing so
|
45
|
at your own expense. Do not expect support from this base theme or the project
|
46
|
you are attempting to integrate the base theme with.
|
47
|
|
48
|
**"Un-supported" modules:**
|
49
|
- Color module (in core)
|
50
|
- [Bootstrap API](https://www.drupal.org/project/bootstrap_api)
|
51
|
- [Bootstrap Library](https://www.drupal.org/project/bootstrap_library)
|
52
|
- [Display Suite](https://www.drupal.org/project/ds)
|
53
|
- [Display Suite Bootstrap Layouts](https://www.drupal.org/project/ds_bootstrap_layouts)
|
54
|
- [LESS module](https://drupal.org/project/less)
|
55
|
- [Panels](https://www.drupal.org/project/panels)
|
56
|
- [Panels Bootstrap Layouts](https://www.drupal.org/project/panels_bootstrap_layouts)
|
57
|
|
58
|
---
|
59
|
|
60
|
### Q: Do you support Internet Explorer? {#ie}
|
61
|
**A: No, not "officially"**
|
62
|
|
63
|
The [Bootstrap Framework] itself does not officially support older Internet
|
64
|
Explorer [compatibility modes](http://getbootstrap.com/getting-started/#support-ie-compatibility-modes).
|
65
|
To ensure you are using the latest rendering mode for IE, consider installing
|
66
|
the [HTML5 Tools](https://drupal.org/project/html5_tools) module.
|
67
|
|
68
|
Internet Explorer 8 requires the use of [Respond.js] to enable media queries
|
69
|
(Responsive Web Design). However, [Respond.js] does not work with CSS that is
|
70
|
referenced via a CSS `@import` statement, which is the default way Drupal
|
71
|
adds CSS files to a page when CSS aggregation is disabled. To ensure
|
72
|
[Respond.js] works properly, enable CSS aggregation at the bottom of:
|
73
|
`admin/config/development/performance`.
|
74
|
|
75
|
---
|
76
|
|
77
|
### Q: Is Drupal Bootstrap a module or theme? {#module-or-theme}
|
78
|
**A: Theme**
|
79
|
|
80
|
More specifically a base theme. It is _not_ a module. Modules are allowed to
|
81
|
participate in certain hooks, while themes cannot. This is a very important
|
82
|
concept to understand and limits themes from participating in a wider range of
|
83
|
functionality.
|
84
|
|
85
|
---
|
86
|
|
87
|
### Q: What does the JavaScript error `TypeError: $(...).on is not a function` mean? {#jquery}
|
88
|
Drupal 7 ships with the `1.4.4` version of jQuery out-of-the-box. The [$.on()](http://api.jquery.com/on/)
|
89
|
method was introduced several versions after this in jQuery version `1.7`.
|
90
|
|
91
|
You must upgrade your site or sub-theme's jQuery Version by installing (and
|
92
|
properly configuring) the [jQuery Update] module to use a jQuery version
|
93
|
compatible with the [Bootstrap Framework]. This is typically a version greater
|
94
|
than or equal to `1.9`.
|
95
|
|
96
|
Ensuring jQuery compatibilities between Drupal, the [Bootstrap Framework] and
|
97
|
other plugins/modules does not fall within the scope of this base theme's
|
98
|
documentation or support.
|
99
|
|
100
|
---
|
101
|
|
102
|
### Q: Where can I discuss an issue in real time? {#irc}
|
103
|
**A: In IRC**
|
104
|
|
105
|
The [Drupal Bootstrap] project and its maintainers use the `#drupal-bootstrap`
|
106
|
channel on the freenode.net IRC network to communicate in real time. Please read
|
107
|
the following for more information on how to the community uses this technology:
|
108
|
[Chat with the Drupal Community on IRC](https://www.drupal.org/irc).
|
109
|
|
110
|
Please keep in mind though, this **IS NOT** a "support" channel. It's primary
|
111
|
use is to discuss issues and to help fix bugs with the base theme itself.
|
112
|
|
113
|
---
|
114
|
|
115
|
### Q: Where should I make changes? {#changes}
|
116
|
**A: In a custom sub-theme**
|
117
|
|
118
|
You should **never** modify any theme or sub-theme that is packaged and released
|
119
|
from Drupal.org. If you do, all changes you have made would be lost once that
|
120
|
theme is updated. This makes keeping track of changes next to impossible.
|
121
|
|
122
|
Instead, you should create a custom sub-theme that isn't hosted on Drupal.org.
|
123
|
|
124
|
[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
|
125
|
[Bootstrap Framework]: http://getbootstrap.com
|
126
|
[Respond.js]: https://github.com/scottjehl/Respond
|
127
|
|
128
|
---
|
129
|
|
130
|
### Q: Why are my sub-theme's `.info` settings ignored? {#theme-settings-ignored}
|
131
|
**A: The database contains a copy of the theme settings and they take
|
132
|
precedence over theme settings stored in the `.info` file.**
|
133
|
|
134
|
This is actually quite a common issue whenever a theme's settings are saved
|
135
|
from the UI. This action stores the settings in the {variables} table of the
|
136
|
database. The workflow for theme_get_setting() merges the settings from the
|
137
|
database on top of the settings found in the theme's `.info` file.
|
138
|
|
139
|
You need to remove the variable `theme_[theme_name]_settings` from the database,
|
140
|
where `[theme_name]` is your sub-theme's machine name (e.g. if your sub-theme
|
141
|
machine name is `my_bootstrap_subtheme`, the variable name would be
|
142
|
`theme_my_bootstrap_subtheme_settings`).
|
143
|
|
144
|
The easiest way to do accomplish this task is to use the following [Drush]
|
145
|
command: `theme_my_bootstrap_subtheme_settings`
|
146
|
|
147
|
If you do not have or use [Drush], you will either have to manually delete this
|
148
|
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)
|
149
|
in a custom module that deletes the variable for you:
|
150
|
|
151
|
```php
|
152
|
/**
|
153
|
* Remove the 'theme_my_bootstrap_subtheme_settings' variable.
|
154
|
*/
|
155
|
function hook_update_N() {
|
156
|
variable_del('theme_my_bootstrap_subtheme_settings');
|
157
|
}
|
158
|
```
|
159
|
|
160
|
[Drush]: http://www.drush.org
|
161
|
[Drupal Bootstrap]: https://www.drupal.org/project/bootstrap
|
162
|
[Bootstrap Framework]: http://getbootstrap.com
|
163
|
[jQuery Update]: https://drupal.org/project/jquery_update
|