4.1.10 StyleVar Changes

Collapse
X
Collapse
 

  • Sebastiano Vassellatti
    started a blog post 4.1.10 StyleVar Changes

    4.1.10 StyleVar Changes

    In vBulletin 4.1.10, in addition to fixing any know bug affecting the stylevar functioning in the front-end, we've done some changes to make stylevars and the stylevar system in general more usable:

    • 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.

    • Paul M
      #14
      Paul M commented
      Editing a comment
      Yes, I wrote a mapping class to do that.

      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.

    • Khaleal
      #15
      Khaleal commented
      Editing a comment
      Will I be having to copy values from old to new stylevars manually? or will they be automatically copied?

    • Sebastiano Vassellatti
      #16
      Sebastiano Vassellatti commented
      Editing a comment
      Originally posted by Khaleal;bt11518
      Will I be having to copy values from old to new stylevars manually? or will they be automatically copied?
      They will be automatically mapped by the upgrader. To know what will be mapped to what, check the right column of the tables in the original blog entry.
    Posting comments is disabled.

Related Topics

Collapse

Working...