1 |
caf16a48
|
Assos Assos
|
<!-- @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 |
4eeb3b46
|
Assos Assos
|
- [Disable Messages](https://www.drupal.org/project/disable_messages)
|
27 |
caf16a48
|
Assos Assos
|
- [jQuery Update](https://www.drupal.org/project/jquery_update)
|
28 |
|
|
- [Icon API](https://www.drupal.org/project/icon)
|
29 |
749b8a23
|
Assos Assos
|
- [Path Breadcrumbs](https://www.drupal.org/project/path_breadcrumbs)
|
30 |
caf16a48
|
Assos Assos
|
- [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 |