Jupiter V5 Migration

[vc_row][vc_column][vc_column_text]In this article you will learn how to migrate to Jupiter V5, taking into account all of the changes that need closer inspection. We anticipate the migration process to be the smoothest ever and It will be just like another theme update. The only thing that might be time consuming during the migration is if you have modified the theme in a child theme. To make sure you complete the migration with the least amount of hassle, we have listed all the things you need to be aware of before upgrading below:[/vc_column_text][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Jupiter V5 Server Requirements[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]Before upgrading to V5.0 make sure you server complies with WordPress environment requirements. We have been using some OOP technics and standards that are not present in php legacy versions (e.g. v5.2.X, v5.3.X). Minimum required version is PHP V5.4+[/vc_column_text][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Update using Envato Toolkit[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]Migration from Jupiter V4.X to Jupiter V5 will not be possible through Envato Toolkit. So you should update it manually using Appearance > Themes > Install Theme.[/vc_column_text][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Update Visual Composer[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]Jupiter V5 will only work with Visual Composer V4.7.5+ so make sure you will update it from Appearance > Install Plugins[/vc_column_text][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Clear Theme Cache[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]In Jupiter V5, we store theme options generated styles, used components assets (Javascript and Styles) into single CSS and JS files. These changes to the theme decrease the page loading time. We collect the features that are being used in a website into a database and keep track of them while you use the site. However in some cases you may need to click on the Clear Theme Cache button. This link appears in the WP header toolbar and you should be logged in as an administrator to see it. This button will flush all stored data as well as static files. In each page visit the content will start to be shaped and generate the static files based on your usage. This feature is still in its beta stage and if you encounter any issues please report it to Artbees Helpdesk.[/vc_column_text][mk_padding_divider size=”20″][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/clear-theme-cache.jpg” image_size=”full” title=”Background Selector Patterns” desc=”A comparison between old and new background selector” caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Patterns in background selector[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]To create a lighter WP, which is easier to use, we have removed the predefined patterns and textures from background selector.  As you can see in the image below you are given only Custom and No Image options (comparing to V4 where you could also choose from predefined patterns).
For those who have used patterns in both Theme Options or Post/Page Meta Options please follow the process below:

  1. From the main package zip file you downloaded from ThemeForest, find patterns.zip
  2. Unzip the package and find the patterns you have used in your site
  3. From background selector module upload the pattern using the custom method.
  4. Repeat this process for all locations where you have used predefined patterns.

[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/background-selector-patterns.jpg” image_size=”full” title=”Background Selector Patterns” desc=”A comparison between old and new background selector” caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Patterns in Page Section & Custom Box Shortcode[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]As with the background selector module, Patterns are removed from Custom Box and Page Section shortcodes. As you can see in the image below, the Background Pattern option is no longer available in V5 page section options.
For those who have used patterns in both Page Section or Custom Box Shortcodes please follow the process below:

  1. From the main package zip file you downloaded from ThemeForest, find patterns.zip
  2. Unzip the package and find the patterns you have used in your site.
  3. Visit your pages and find locations where you see missing images.
  4. Edit shortcode and upload your patterns and choose the one you used in V.4
  5. Repeat this process for all locations where you have used predefined patterns.

[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/page-section-patterns.jpg” image_size=”full” title=”Page Section Background pattern option” desc=”This option has been removed in Jupiter V5″ caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Remove Space before and after Page Section options[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]These options were deprecated in Jupiter V4.x and have been removed in V5. You will need to use the stick template option in post meta options to remove space between page sections.[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/first-last-page.jpg” image_size=”full” title=”Remove space before and after Page Section” desc=”These options were deprecated and have been removed in Jupiter V5″ caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Removal of iCarousel slideshow from theme core features[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]We have removed the iCarousel slideshow, post type, shortcode from the theme base feature due to minimum usage by our users. We will convert it to a Jupiter Addon and introduce it very soon to the collection. If you are using this module in site, stay tuned for Jupiter V5.1[/vc_column_text][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Slideshow settings & Jupiter Video banner Metaboxes[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]The meta options below were long deprecated and have finally been removed in V5. You can use Visual composer to create slideshows and page section shortcode for having video banner layers. We have removed them to increase rendering speed in post editing.[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/banner-settings.jpg” image_size=”full” title=”Jupiter Slideshow Settings” desc=”The above meta options have been removed and you will need to use visual composer to add your slideshows” caption_location=”outside-image” align=”center”][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/banner-settings.jpg” image_size=”full” title=”Jupiter Video Banner Settings” desc=”You can use page section to generate the same look” caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Theme Options > Header > Start Tour Page option needs update.[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]The “Start a Tour” module located in the header will need to be checked for option modifications. If you compare the screenshots below, you will notice you used to choose from options to select a link. However, in V5 you will need to paste a URL in the text field.[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/start-a-tour-link.jpg” image_size=”full” title=”Start a Tour” desc=”This feature needs updates if you are using it in your website.” caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Font Weights might be reset in some Theme Options Typography[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]In order to support the whole range of font weights starting from 100 to 900 font weights, we have added many more options. You may experience some font weight options being reset. Make sure you keep track of them before you update so you can check and set them again if required.[/vc_column_text][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row id=”fontface”][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]FontFaces have been removed[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]We have removed “Self Hosted FontFaces” from theme as they seem to be one of those deprecated typography technologies. Instead we only offer full list of Google Fonts, Typekit and of course Safe Fonts. If you still wish to use a FontFace you will need to install Use Any Font plugin which offers custom font upload.[/vc_column_text][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Child theme and shortcode override changes[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]If you have ever overridden Jupiter shortcodes in a child theme, there are a couple of things you need to do before migrating to Jupiter V5!
In V4.X and older versions the folder structure for shortcodes was as follows: shortcodes/shortcode_name.php
In V5.X we have changed it to “architecture by feature” meaning that its configurations, styles, scripts and shortcode options stay on the same folder. You can also override its assets and options as well (which was previously not possible).
Old Method :
jupiter/shortcodes/mk_button.php
New Method :
jupiter/components/shortcodes/mk_button/mk_button.php
jupiter/components/shortcodes/mk_button/mk_button.css
jupiter/components/shortcodes/mk_button/vc_map.php
jupiter/components/shortcodes/mk_button/config.php[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/components-shortcodes-mk-button.jpg” image_size=”full” title=”Shortcodes Architecture” desc=”Overriding shortcodes in Jupiter V5 is a different process” caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row][vc_row][vc_column][mk_fancy_title tag_name=”h4″ color=”#444444″ size=”18″ font_weight=”bold” txt_transform=”capitalize” letter_spacing=”1″ margin_bottom=”0″ font_family=”none”]Woocommerce Single Product Image Size[/mk_fancy_title][mk_divider style=”thin_solid” divider_width=”custom_width” custom_width=”25″ align=”left” thin_single_color=”#fe5320″ thickness=”3″ margin_top=”5″][vc_column_text]In Jupiter V5 the WooCommerce single product image size is being managed from the location shown below. If you see quality loss in the image, simply go to the WooCommerce settings and change the size to 550×550 pixels.[/vc_column_text][mk_image src=”http://demos.artbees.net/jupiter5/wp-content/uploads/2015/12/woocommerce-single-image.jpg” image_size=”full” title=”WooCommerce Single Image Size” desc=”Image size is now being managed by WP native resize.” caption_location=”outside-image” align=”center”][mk_padding_divider size=”60″][/vc_column][/vc_row]