- Added a description and name phrase to all stylevars. This will help identify what is affected by each stylevar.
- Reorganized the current grouping of stylevars in stylevar groups in Admin CP. See VBIV-13763 for the details.
- Removed a bunch of existing stylevars. This was done by both checking if stylevars were actually used (over 30 were found to be unused), and by reviewing and removing a number of stylevars used only in very small areas, in favour of some more general stylevars, but still attempting not to reduce the great customization flexibility provided by stylevars.
- Added a new "Remove Orphan Stylevars" tool that will allow to cleanup all deprecated stylevars that still exist on your installs. For more details, see the dedicated blog entry.
As a result of the 4.1.10 stylevar changes, there have been a number of stylevars removed, added or renamed. In order to facilitate the upgrade of custom styles, most of the added stylevars and all the renamed stylevars will have their values mapped from the previous stylevars (for the system, a renamed stylevar counts as a stylevar removed, and another added). The aim of mapping is to allow your styles to remain as identical as possible to how they were before the upgrade, by silently doing stylevar updates behind the scenes.
The tables below illustrate which stylevars have been removed, added, renamed and what stylevar values will be mapped into new stylevars. A red table cell background indicates a removed stylevar, a green table cell background indicates a new stylevar, and a blue table cell indicates a renamed stylevar.
vBulletin StyleVars
Removed StyleVars | Replacement StyleVars, Mapping & Notes |
albumedit_thumbnailedit_width | No Replacement Removed to fix issue VBIV-13564. |
albumlist_entry_width | No Replacement This stylevar was unused. |
Added assetmanager_attachment_background, no mapping New stylevar. It controls the background of attachments in the asset manager, which was previously hardcoded. |
|
Added assetmanager_attachment_background_selected, no mapping New stylevar. It controls the background of selected attachments in the asset manager, which was previously hardcoded. |
|
Added assetmanager_attachment_border, no mapping New stylevar. It controls the border of attachments in the asset manager, which was previously hardcoded. |
|
Added assetmanager_attachment_color, no mapping New stylevar. It controls the text color of attachments in the asset manager, which was previously hardcoded. |
|
Added assetmanager_border, no mapping New stylevar. It controls the border of the asset manager, which was previously hardcoded. |
|
Added assetmanager_panel_background, no mapping New stylevar. It controls the background of panels in the asset manager, which was previously hardcoded. |
|
Added assetmanager_panel_color, no mapping New stylevar. It controls the text color of panels in the asset manager, which was previously hardcoded. |
|
Added assetmanager_panel_footer_background, no mapping New stylevar. It controls the background of panel footers in the asset manager, which was previously hardcoded. |
|
Added assetmanager_panel_footer_color, no mapping New stylevar. It controls the text color of panel footers in the asset manager, which was previously hardcoded. |
|
Added assetmanager_panel_header_background, no mapping New stylevar. It controls the background of panel headers in the asset manager, which was previously hardcoded. |
|
Added assetmanager_panel_header_color, no mapping New stylevar. It controls the text color of panel headers in the asset manager, which was previously hardcoded. |
|
Added assetmanager_resize_background, no mapping New stylevar. It controls the background of the area between the different panels in the asset manager, which was previously hardcoded. |
|
Added assetmanager_upload_background, no mapping New stylevar. It controls the background of the file list in the advanced uploader (used by the asset manager and editor Insert Image popup if enabled), which was previously hardcoded. |
|
Added assetmanager_upload_color, no mapping New stylevar. It controls the text color of the file list in the advanced uploader (used by the asset manager and editor Insert Image popup if enabled), which was previously hardcoded. |
|
attachment_blockquote_caption_color | No Replacement This stylevar was unused. |
avatar_height | No Replacement Removed to fix issues VBIV-13218 and VBIV-13596. |
Added bbcode_table_border, "Color" mapped from vbcms_wysiwyg_table_borderColor New stylevar. Allows to control all border properties of tables created with BB code; previously using a CMS stylevar only for the color definition, and referencing a non-existent stylevar for the border width. |
|
block_border block_color block_font block_padding |
No Replacement No Replacement No Replacement No Replacement Removed because unused by default (i.e. all their values were blank), and their customization caused issues because of the too widespread affected areas. |
blocksubhead_outline | No Replacement This stylevar was unused. |
bodyheader_margin | Replaced by and mapped to header_margin Only a rename. It controls the margin of the header. |
button_control_border | No Replacement This stylevar was "duplicating" control_border, which will now control also the areas previously controlled by button_control_border. |
calendarwidget_day_font calendarwidget_daylink_font calendarwidget_monthnav_background calendarwidget_monthnav_font calendarwidget_weekdays_background calendarwidget_weekdays_border calendarwidget_weekdays_font |
Replaced by and mapped to vbcms_calendarwidget_day_font Replaced by vbcms_calendarwidget_day_font Replaced by and mapped to vbcms_calendarwidget_monthnav_background Replaced by and mapped to vbcms_calendarwidget_monthnav_font Replaced by and mapped to vbcms_calendarwidget_weekdays_background Replaced by and mapped to vbcms_calendarwidget_weekdays_border Replaced by and mapped to vbcms_calendarwidget_weekdays_font See the six stylevars in the vBulletin CMS StyleVars table for details. |
calendar_th_blocksubhead_border | No Replacement This stylevar was usused. |
content1_background | No Replacement This stylevar was unused. |
content2_background | No Replacement This stylevar was used only to control the background of highlighted days in date pickers. Now it will be controlled by general_hilite_color. |
content3_background | Replaced by and mapped to bbcode_code_background This stylevar was used in a few unrelated areas, which could result into problems when customizing it. Its use has been removed from all those areas, except for the background of CODE, HTML and PHP BB code blocks (more details in VBIV-13753). |
content_font | Replaced by font Was used only in a couple of unrelated areas for the Font Family definition. Those areas will now use the Font Family definition of font. |
control_focus_background | Replaced by and mapped to input_focus_background Only a rename. It controls the background of input fields when they have focus. |
Added editor_text_color, no mapping New stylevar. Controls the text color of the editor, which was previously an hard-coded color. |
|
editor_wysiwyg_table_borderColor editor_wysiwyg_table_borderSize |
Replaced by and mapped "Color", "Units" and "Size" into editor_wysiwyg_table_border Combined into a single stylevar, now allowing to control all border properties of tables in the WYSIWYG editor. |
forum_msg_font | Replaced by and mapped to postbit_font Only a rename. It controls the font in the areas controlled by other postbit stylevars (forum posts, forum announcements, private messages, calendar events and user notes). |
forum_sidebar_link_color forum_sidebar_linkhover_color |
Replaced by and mapped to sidebar_content_link_color Replaced by and mapped to sidebar_content_linkhover_color They were controlling link color and link hover color in the forum sidebar, now they will control these also in CMS widgets and blog sidebar. |
forum_sidebar_time_color | Replaced by time_color This controlled the color of time in the forum sidebar. It will now be controlled by the global time_color stylevar. |
foruminfo_header_background foruminfo_header_border foruminfo_header_color |
No Replacement No Replacement No Replacement These stylevars were unused. |
foruminfo_header_font | Replaced by mid_fontSize This stylevar was used only for a CSS position calculation, which now uses mid_fontSize. |
forummenu_background forummenu_border forummenu_border_radius |
No Replacement No Replacement No Replacement These stylevars were unused. |
Added general_hilite_color, mapped from imodhilite_backgroundColor imodhilite_backgroundColor was used to control the background of any highlighted element; it now controls only the background of items selected for inline moderation, and most of the other areas it was affecting will now use general_hilite_color. |
|
image_large_max | Replaced by and mapped to attachment_image_large_max This stylevar controls the maximum size of attached images when they're set to "Large" Size in their Image Settings; it was renamed to make this more clear, and also fixed to work everywhere (previously worked only in editor and CMS). |
image_medium_max | Replaced by and mapped to image_max_size This stylevar controls the maximum size of images; it was renamed to make this more clear and differentiate it from the other image_ (now attachment_image_) stylevars, and was also fixed to work across the entire product. |
image_small_max | Replaced by and mapped to attachment_image_medium_max This stylevar controls the maximum size of attached images when they're set to "Medium" Size in their Image Settings; it was renamed to make this more clear, and also fixed to work everywhere (previously worked only in editor and CMS). |
image_thumbnail_max | Replaced by and mapped to attachment_image_thumbnail_max This stylevar controls the maximum size of attached images when they're set to "Thumbnail" Size in their Image Settings; it was renamed to make this more clear, and also fixed to work everywhere (previously worked only in editor and CMS). |
imgdir_gradients | No Replacement This stylevar was used only in couple areas for some hardcoded definitions. They're now no longer hardcoded, and so this made this stylevar redundant. |
imodhilite_color | No Replacement This stylevar become unused as part of fixing issues VBIV-3758 and VBIV-12241. |
Added input_border, mapped "Color" from mid_border New stylevar. Allows to control all properties of input field borders, which were previously hardcoded except for the color that was controlled by mid_border. |
|
input_borderColor | Replaced by input_border This controlled the border color of two input fields in the blog area. They will now follow the same stylevar used by any other input field border. |
Added input_color, no mapping New stylevar. Controls the text color of input fields, which was previously an hardcoded color. |
|
Added input_font, mapped from control_font control_font previously controlled the font of both buttons and input fields. It now controls the font only of buttons, and the font of input fields is controlled by input_font. |
|
lightweightbox_background lightweightbox_border |
Replaced by and mapped to picture_background Replaced by and mapped to picture_border The lightweightbox stylevars controlled too many unrelated areas, which could result in issues when customizing them. They controlled the background of the Picture URL input fields in album pictures (now use input_background), the character navigation in the member list (background is now transparent, border is controlled by light_border), the hover effect of breadcrumbs (hover effect removed), and pictures. The last is the only area they still control, with their new name. |
member_popupmenu_shadow_color | Replaced by shadow_color This controlled the shadow color of the user name popup menu. It now uses the general shadow_color. |
navbar_background_notify | Replaced by and mapped to toplinks_hilite_background This controlled the background of the Notifications menu in the header; toplinks_hilite_background now controls that as well as the background of the other top links when they're hovered over. |
navbarsearch_borderWidth navbarsearch_input_borderColor |
Replaced by input_border Made the navbar search input field follow the same border styling of other input fields. |
navbarsearch_padding | No Replacement This stylevar was unused. |
Added navbar_menu_height, mapped Height from navbar_tab_size Controls the height of the navbar menu area, which was previously controlled by the Height value of navbar_tab_size. |
|
navbar_padding | Replaced by and mapped to navbar_tab_padding Only a rename. It controls the padding of the navbar tabs. |
navbar_popup_link_background | Replaced by popupmenu_link_background and navbar_popupmenu_link_background This controlled the background of the Notification popup menu rows. They will now follow the new popupmenu stylevars. |
Added navbar_popupmenu_link_background, mapped from formrow_background Controls the background of the navbar popup menu rows. |
|
Added navbar_popupmenu_link_color, mapped from navbar_selected_popup_body_a_Color Controls the text color of the navbar popup menu rows. |
|
Added navbar_popupmenu_link_hover_background, mapped from imodhilite_backgroundColor Controls the background of the navbar popup menu rows while being hovered over with the mouse. |
|
Added navbar_popupmenu_link_hover_color, mapped from navbar_selected_popup_body_a_Color Controls the text color of the navbar popup menu rows while being hovered over with the mouse. |
|
navbar_selected_popup_body_a_Color | Replaced by and mapped to navbar_popupmenu_link_color and navbar_popupmenu_link_hover_color See above for the two new stylevar details. |
navbar_tab_linkhover_color | Replaced by and mapped to navbar_tab_selected_color Only a rename. It controls the text color of the selected navbar tab. |
navbar_tab_selected_top_width | Replaced by and mapped to navbar_tab_selected_top_height Only a rename. It controls the extra height added above the selected navbar tab. |
popupmenu_color | Replaced by and mapped to popupmenu_link_color and popupmenu_link_hover_color See below for the two new stylevar details. |
Added popupmenu_height, mapped Height from navbar_tab_size Controls the height of popup menu rows, which was previously controlled by the Height value of navbar_tab_size. |
|
popupmenu_label_color | Replaced by and mapped to popupmenu_color Only a rename. It controls the text color of items in popup menu that aren't within a popup menu row. |
Added popupmenu_link_background, mapped from formrow_background Controls the background of the popup menu rows. |
|
Added popupmenu_link_color, mapped from popupmenu_color Controls the text color of the popup menu rows. |
|
Added popupmenu_link_hover_background, mapped from imodhilite_backgroundColor Controls the background of the popup menu rows while being hovered over with the mouse. |
|
Added popupmenu_link_hover_color, mapped from popupmenu_color Controls the text color of the popup menu rows while being hovered over with the mouse. |
|
postbit_boxed_background postbit_boxed_border postbit_boxed_fontSize postbit_boxed_padding |
Replaced by and mapped to attachment_box_background Replaced by and mapped to attachment_box_border Replaced by and mapped to attachment_box_fontSize Replaced by and mapped to attachment_box_padding Only renames. These stylevars controls the attachment box display when non-inline attachments are present (in CMS articles, blog entries and forum posts). |
postbitlegacy_avatar_border | No Replacement Was blank by default, set a border around avatars in postbit legacy if customized. Removed because this behaviour was inconsistent with any other area of the product. |
postbitlegacy_avatar_outline | No Replacement Was blank by default, set an outer line around avatars in postbit legacy if customized. Removed because this behaviour was inconsistent with any other area of the product. |
postfoot_separator_color postfoot_separator_width |
Replaced by and mapped "Color", "Units" and "Size" into postbit_foot_separator Combined into a single stylevar, now allowing to control all properties of the vertical line that separates the different buttons in postbit. |
profile_content_friends_list_hover profile_content_infractions_background profile_content_infractions_li_hover_background profile_content_infractions_li_hover_border profile_content_subsectionhead_color profile_content_subsectionhead_link_border_bottom profile_contentheader_border profile_pagetitle_font profile_sidebar_avatar_background |
No Replacement No Replacement No Replacement No Replacement No Replacement No Replacement No Replacement No Replacement No Replacement These stylevars were unused. |
projecticon_box_size projecticon_size |
No Replecement These stylevars were unused. |
restore_font_size | No Replacement This stylevar was unused. |
selected_border | No Replacement This stylevar was unused. |
shade_deep_color | Replace by signature_border and shade_color This stylevar controlled the line that separates the signature from the post content in post previews (now uses signature_color), and the text of the PM/Email buttons on the site leaders page (now uses shade_color) |
shade_mid_color | No Replacement This stylevar was unused. |
Added sidebar_content_padding, mapped from vbcms_widget_content_padding Made vbcms_widget_content_padding a global sidebar stylevar that controls the padding in forum sidebar, blog sidebar and CMS widgets. |
|
Added sidebar_postbit_header_font, mapped from vbcms_widget_postbit_header_font Made vbcms_widget_postbit_header_font a global sidebar stylevar that controls the font of content titles in forum sidebar, blog sidebar and CMS widgets. |
|
Added sidebar_postbit_small_fontSize, mapped from vbcms_widget_postbit_small_fontSize Made vbcms_widget_postbit_small_fontSize a global sidebar stylevar that controls the font size of content details (i.e. author, date, etc.) in forum sidebar, blog sidebar and CMS widgets. |
|
texthilite_color | Replaced by and mapped to highlight_color Renamed and fixed to control the text color of highlighted text (whose background is controlled by highlight_background). This previously worked only in the BB code list page. |
toolsmenu_bevel | No Replacement Removed to fix part of issue VBIV-12241. |
toplinks_form_input | Replaced by input_color Controlled the text color of the login input fields in the header, now follows the same stylevar used for the text color of any other input field. |
toplinks_form_input_defaultValue | Replaced by shade_color Controlled the text color of the default text present in the header login input fields, now uses the same stylevar used for any other shaded text. |
toplinks_input_login_backgroundColor | No Replacement Controlled the background color of the login button in the header. Was transparent by default. |
toplinks_text | Replaced by and mapped to toplinks_color Only a rename. Controls the text color of the top links in the header (in fact, it's just "Welcome," and "Remember Me?"). |
usercp_forum_icon_legend_background usercp_forum_icon_legend_border usercp_forum_icon_legend_top_border |
Replaced by blockhead_background Replaced by blockhead_border Replaced by blockhead_border Icon Legends in the Settings page will now use existing Block stylevars to be styled. |
wysiwyg_block_background_image | No Replacement Removed to fix issue VBIV-7172. |
vBulletin Blog StyleVars
Removed Stylevars | Replacement StyleVars, Mapping & Notes |
Added vbblog_body_background, mapped from body_background New stylevar. Controls the body background in the blog, previously controlled by the global body_background. |
|
vbblog_comment_header_color | Replaced by body_color This stylevar controlled the text color of the "Comments" and "Trackbacks" labels when viewing a blog entry. |
Added vbblog_entry_background, no mapping New stylevar. Controls the background of blog entries; is defaulted to transparent, as that background previously was. |
|
vbblog_input_font | No Replacement This stylevar was unused. |
vbblog_link_color | Replaced by link_color This controlled the color of linked user names in the blog. This behaviour was incosistent with any other area of the product. |
Added vbblog_listrow_background, no mapping New stylevar. This controls the background of rows in blog lists and in blog category lists, previously hardcoded. |
|
vbblog_sidebar_avatar_maxSize | No Replacement This stylevar was unused. |
vBulletin CMS StyleVars
Removed StyleVars | Replacement StyleVars, Mapping & Notes |
vbcms_article_font vbcms_article_image_caption_color vbcms_article_image_caption_font |
No Replacement No Replacement No Replacement These stylevars were unused. |
vbcms_article_mid_fontSize | Replaced by mid_fontSize This controlled the "X Coments" and "Read More..." text in CMS section pages. |
vbcms_article_small_fontSize | No Replacement This stylevar was unused. |
vbcms_article_subheader_font | Replaced by big_fontSize and font This controlled the font of the "X Comments" label in the CMS content pages. The font size will now be set by big_fontSize, the rest of the font properties will follow the global font. |
Added vbcms_body_background, mapped from body_background New stylevar. Controls the body background in the CMS, previously controlled by the global body_background. |
|
Added vbcms_calendarwidget_day_font, mapped from calendarwidget_day_font Previosuly classified as a vBulletin core stylevar, this actually was working just in the CMS area. It controls the font of days in the CMS calendar widget. |
|
Added vbcms_calendarwidget_monthnav_background, mapped from calendarwidget_monthnav_background Previosuly classified as a vBulletin core stylevar, this actually was working just in the CMS area. It controls the background of the month navigation in the CMS calendar widget. |
|
Added vbcms_calendarwidget_monthnav_font, mapped from calendarwidget_monthnav_font Previosuly classified as a vBulletin core stylevar, this actually was working just in the CMS area. It controls the font of the month navigation in the CMS calendar widget. |
|
Added vbcms_calendarwidget_weekdays_background, mapped from calendarwidget_weekdays_background Previosuly classified as a vBulletin core stylevar, this actually was working just in the CMS area. It controls the background of week days in the CMS calendar widget. |
|
Added vbcms_calendarwidget_weekdays_border, mapped from calendarwidget_weekdays_border Previosuly classified as a vBulletin core stylevar, this actually was working just in the CMS area. It controls the border of week days in the CMS calendar widget. |
|
Added vbcms_calendarwidget_weekdays_font, mapped from calendarwidget_weekdays_font Previosuly classified as a vBulletin core stylevar, this actually was working just in the CMS area. It controls the font of week days in the CMS calendar widget. |
|
vbcms_editor_border | Replaced by input_border This stylevar controlled the border of all input fields in the CMS. Now follows the same stylevar that controls the border of all other input fields. |
vbcms_editor_small_fontSize vbcms_editor_tiny_fontSize |
No Replacement No Replacement These stylevars were unused. |
vbcms_error_color | No Replacement This stylevar was unused. |
vbcms_widget_content_padding vbcms_widget_postbit_header_font vbcms_widget_postbit_small_fontSize |
Replaced by and mapped to sidebar_content_padding Replaced by and mapped to sidebar_postbit_header_font Replaced by and mapped to sidebar_postbit_small_fontSize See the three stylevars in the vBulletin StyleVars table for details. |
vbcms_wysiwyg_table_borderColor | Replaced by and mapped "Color" into bbcode_table_border See bbcode_table_border in the vBulletin StyleVars table for details. |
There are over 60 mappings in the upgrade steps, one of which maps 'forum_sidebar_link_color' to 'sidebar_content_link_color'.
It will do this in any style where it finds a customised value of the source (old) stylevar.