sub-topic Theme Settings

To override a setting, open ./config/install/THEMENAME.settings.yml and add the following:

# Settings

settings:
  SETTING_NAME: SETTING_VALUE

Advanced

Setting nameDescription and default value
include_deprecated
Enabling this setting will include any deprecated.php file found in your theme or base themes.
include_deprecated: 0
suppress_deprecated_warnings
Enable this setting if you wish to suppress deprecated warning messages. WARNING: Suppressing these messages does not "fix" the problem and you will inevitably encounter issues when they are removed in future updates. Only use this setting in extreme and necessary circumstances.
suppress_deprecated_warnings: 0

Advanced > CDN (Content Delivery Network)

Setting nameDescription and default value
cdn_provider
Choose between jsdelivr or a custom cdn source.
cdn_provider: jsdelivr
cdn_custom_css
It is best to use https protocols here as it will allow more flexibility if the need ever arises.
cdn_custom_css: 'https://cdn.jsdelivr.net/bootstrap/3.3.7/css/bootstrap.css'
cdn_custom_css_min
Additionally, you can provide the minimized version of the file. It will be used instead if site aggregation is enabled.
cdn_custom_css_min: 'https://cdn.jsdelivr.net/bootstrap/3.3.7/css/bootstrap.min.css'
cdn_custom_js
It is best to use https protocols here as it will allow more flexibility if the need ever arises.
cdn_custom_js: 'https://cdn.jsdelivr.net/bootstrap/3.3.7/js/bootstrap.js'
cdn_custom_js_min
Additionally, you can provide the minimized version of the file. It will be used instead if site aggregation is enabled.
cdn_custom_js_min: 'https://cdn.jsdelivr.net/bootstrap/3.3.7/js/bootstrap.min.js'
cdn_jsdelivr_version
Choose the Bootstrap version from jsdelivr
cdn_jsdelivr_version: 3.3.7
cdn_jsdelivr_theme
Choose the example Bootstrap Theme provided by Bootstrap or one of the Bootswatch themes.
cdn_jsdelivr_theme: bootstrap

Components > Breadcrumbs

Setting nameDescription and default value
breadcrumb
Show or hide the Breadcrumbs
breadcrumb: '1'
breadcrumb_home
If your site has a module dedicated to handling breadcrumbs already, ensure this setting is enabled.
breadcrumb_home: 0
breadcrumb_title
If your site has a module dedicated to handling breadcrumbs already, ensure this setting is disabled.
breadcrumb_title: 1

Components > Navbar

Setting nameDescription and default value
navbar_inverse
Select if you want the inverse navbar style.
navbar_inverse: 0
navbar_position
Determines where the navbar is positioned on the page.
navbar_position: ''

Components > Region Wells

Setting nameDescription and default value
region_wells
Enable the .well, .well-sm or .well-lg classes for specified regions.
region_wells:
  navigation: ''
  navigation_collapsible: ''
  header: ''
  highlighted: ''
  help: ''
  content: ''
  sidebar_first: ''
  sidebar_second: well
  footer: ''

General > Buttons

Setting nameDescription and default value
button_colorize
Adds classes to buttons based on their text value.
button_colorize: 1
button_iconize
Adds icons to buttons based on the text value
button_iconize: 1
button_size
Defines the Bootstrap Buttons specific size
button_size: ''

General > Container

Setting nameDescription and default value
fluid_container
Uses the .container-fluid class instead of .container.
fluid_container: 0

General > Forms

Setting nameDescription and default value
forms_has_error_value_toggle
If an element has a .has-error class attached to it, enabling this will automatically remove that class when a value is entered.
forms_has_error_value_toggle: 1
forms_required_has_error
If an element in a form is required, enabling this will always display the element with a .has-error class. This turns the element red and helps in usability for determining which form elements are required to submit the form.
forms_required_has_error: 0
forms_smart_descriptions
Convert descriptions into tooltips (must be enabled) automatically based on certain criteria. This helps reduce the, sometimes unnecessary, amount of noise on a page full of form elements.
forms_smart_descriptions: 1
forms_smart_descriptions_allowed_tags
Prevents descriptions from becoming tooltips by checking for HTML not in the list above (i.e. links). Separate by commas. To disable this filtering criteria, leave an empty value.
forms_smart_descriptions_allowed_tags: 'b, code, em, i, kbd, span, strong'
forms_smart_descriptions_limit
Prevents descriptions from becoming tooltips by checking the character length of the description (HTML is not counted towards this limit). To disable this filtering criteria, leave an empty value.
forms_smart_descriptions_limit: '250'

General > Images

Setting nameDescription and default value
image_responsive
Images in Bootstrap 3 can be made responsive-friendly via the addition of the .img-responsive class. This applies max-width: 100%; and height: auto; to the image so that it scales nicely to the parent element.
image_responsive: 1
image_shape
Add classes to an <img> element to easily style images in any project.
image_shape: ''

General > Tables

Setting nameDescription and default value
table_bordered
Add borders on all sides of the table and cells.
table_bordered: 0
table_condensed
Make tables more compact by cutting cell padding in half.
table_condensed: 0
table_hover
Enable a hover state on table rows.
table_hover: 1
table_responsive
Makes tables responsive by wrapping them in .table-responsive to make them scroll horizontally up to small devices (under 768px). When viewing on anything larger than 768px wide, you will not see any difference in these tables.
table_responsive: 1
table_striped
Add zebra-striping to any table row within the <tbody>.
table_striped: 1

JavaScript > Modals

Setting nameDescription and default value
modal_enabled
Enabling this will replace core's jQuery UI Dialog implementations with modals from the Bootstrap Framework.
modal_enabled: 1
modal_animation
Apply a CSS fade transition to modals.
modal_animation: 1
modal_backdrop
Includes a modal-backdrop element. Alternatively, specify static for a backdrop which doesn't close the modal on click.
modal_backdrop: 'true'
modal_keyboard
Closes the modal when escape key is pressed.
modal_keyboard: 1
modal_show
Shows the modal when initialized.
modal_show: 1
modal_size
Defines the modal size between the default, modal-sm and modal-lg.
modal_size: ''

JavaScript > Popovers

Setting nameDescription and default value
popover_enabled
Elements that have the data-toggle="popover" attribute set will automatically initialize the popover upon page load. WARNING: This feature can sometimes impact performance. Disable if pages appear to hang after initial load.
popover_enabled: 1
popover_animation
Apply a CSS fade transition to the popover.
popover_animation: 1
popover_container
Appends the popover to a specific element. Example: body. This option is particularly useful in that it allows you to position the popover in the flow of the document near the triggering element - which will prevent the popover from floating away from the triggering element during a window resize.
popover_container: body
popover_content
Default content value if data-content or data-target attributes are not present.
popover_content: ''
popover_delay
The amount of time to delay showing and hiding the popover (in milliseconds). Does not apply to manual trigger type.
popover_delay: '0'
popover_html
Insert HTML into the popover. If false, jQuery's text method will be used to insert content into the DOM. Use text if you're worried about XSS attacks.
popover_html: 0
popover_placement
Where to position the popover. When auto is specified, it will dynamically reorient the popover. For example, if placement is auto left, the popover will display to the left when possible, otherwise it will display right.
popover_placement: right
popover_selector
If a selector is provided, tooltip objects will be delegated to the specified targets. In practice, this is used to enable dynamic HTML content to have popovers added.
popover_selector: ''
popover_title
Default title value if title attribute isn't present.
popover_title: ''
popover_trigger
How a popover is triggered.
popover_trigger: click
popover_trigger_autoclose
Will automatically close the current popover if a click occurs anywhere else other than the popover element.
popover_trigger_autoclose: 1

JavaScript > Tooltips

Setting nameDescription and default value
tooltip_enabled
Elements that have the data-toggle="tooltip" attribute set will automatically initialize the tooltip upon page load. WARNING: This feature can sometimes impact performance. Disable if pages appear to "hang" after initial load.
tooltip_enabled: 1
tooltip_animation
Apply a CSS fade transition to the tooltip.
tooltip_animation: 1
tooltip_container
Appends the tooltip to a specific element. Example: body.
tooltip_container: body
tooltip_delay
The amount of time to delay showing and hiding the tooltip (in milliseconds). Does not apply to manual trigger type.
tooltip_delay: '0'
tooltip_html
Insert HTML into the tooltip. If false, jQuery's text method will be used to insert content into the DOM. Use text if you're worried about XSS attacks.
tooltip_html: 0
tooltip_placement
Where to position the tooltip. When auto is specified, it will dynamically reorient the tooltip. For example, if placement is auto left, the tooltip will display to the left when possible, otherwise it will display right.
tooltip_placement: 'auto left'
tooltip_selector
If a selector is provided, tooltip objects will be delegated to the specified targets.
tooltip_selector: ''
tooltip_trigger
How a tooltip is triggered.
tooltip_trigger: hover

Parent topics

Source docs/Theme-Settings.md (line 4)

Sub-Topics

Namesort descending Description
Theme Settings Overview of theme settings for Drupal Bootstrap based themes.