purothemes / polestar Goto Github PK

=== Polestar ===

Contributors: Puro

Tags: one-column, two-columns, left-sidebar, right-sidebar, custom-background, custom-colors, custom-menu, custom-logo, featured-images, footer-widgets, full-width-template, post-formats, sticky-post, theme-options, threaded-comments, translation-ready, blog, e-commerce

Tested up to: 6.0
Requires at least: 4.7
Requires PHP: 5.6.20
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Lead the way with Polestar. It's fast loading, responsive, lightweight and flexible design is perfectly suited for building dynamic pages with SiteOrigin's Page Builder and selling with WooCommerce.

== Description ==

Lead the way with Polestar. It's fast loading, responsive, lightweight and flexible design is perfectly suited for building dynamic pages with SiteOrigin's Page Builder and selling with WooCommerce. Ecommerce features include a menu mini-cart and product quick-view. Polestar features a sticky header, beautiful header search, scroll to top and just the right amount of Customizer theme settings. Page level settings let you adjust the theme layout on a page by page basis, perfect for landing pages. If you run a blog, Polestar is ready with awesome features including a full-width posts slider integrated with Jetpack Featured Content, an author box and related posts section.

== Installation ==

1. Login to your WordPress installation and go to Appearance > Themes > Add New > Upload Theme.
2. Click Choose File and browse to the theme's ZIP file on your computer. Click Install Now.
3. Click Activate to get started with your new theme right away.

== Documentation ==

[Documentation](https://purothemes.com/documentation/polestar-wordpress-theme/) is available on purothemes.com.

== Support ==

[Support](https://purothemes.com/support/forum/polestar-theme/) is available on purothemes.com.

== Frequently Asked Questions ==

= How do I setup the posts slider? =

The posts slider uses the [Jetpack Featured Content](https://jetpack.com/support/featured-content/).

1. If you don't yet have Jetpack installed, go to Plugins > Add New, search for Jetpack, install, activate and connect to your WordPress.com account as instructed. 
2. Go to Appearance > Customize > Featured Content and insert a tag name. Any posts tagged with the tag name entered will be featured in your slider.
3. Go to Posts and add the featured tag to the posts you'd like to display in your slider. When editing a post, the Tags meta box is located in the right column.

The slider will then automatically display on your blog home page (Front page displays: Your latest posts) or assigned posts (blog) page.

= How do I add social network icons to the footer menu? =

1. The Polestar footer menu supports social network icon links as used by many other themes. Icons are rendered by the [Font Awesome library](http://fontawesome.io/icons/). 

2. To add a social network icon or icons to the footer menu, go to Appearance > Menus. If you haven't yet created a menu for the footer menu location, click the "create a new menu" link. Scroll down to the bottom of the page and locate the Theme Locations sub-heading under the Menu Settings heading, select the Footer option and click the blue "Save Menu" button. 

3. Next look at the left column and locate the "Custom Links" tab, open it and add your first network. For example if we were adding a Twitter icon for Puro Themes we'd add the following to the URL field: https://twitter.com/purothemes. The URL should be a link to your profile page on one of the supported networks below. The Link Text can be anything you'd like, it won't be displayed on the front end of your site.

4. The footer menu location supports both regular links and social network links. If a link matches one of the icons below, an icon will be displayed. If a link doesn't match one of the icons below, the regular link text/label will be displayed.

Available icons:

* Behance
* CodePen
* Delicious
* deviantART
* Digg
* Dribbble
* Facebook
* Flickr
* Foursquare
* GitHub
* Google Plus
* Instagram
* LinkedIn
* Pinterest
* reddit
* SoundCloud
* StackExchange
* Stack Overflow
* Tumblr
* Twitter
* Vimeo
* Vine
* Vk
* Weibo
* WordPress.com
* Xing
* Yelp
* YouTube

== Plugin Support ==

Polestar includes support for the following plugins:

* [Breadcrumb NavXT](https://wordpress.org/plugins/breadcrumb-navxt/)
* [Jetpack Featured Content](https://jetpack.com/support/featured-content/)
* [Jetpack Infinite Scroll](https://jetpack.com/support/infinite-scroll/)
* [Jetpack Related Posts](https://jetpack.com/support/related-posts/)
* [Max Mega Menu](https://wordpress.org/plugins/megamenu/)
* [Page Builder by SiteOrigin](https://wordpress.org/plugins/siteorigin-panels/)
* [Rank Math Breadcrumbs](https://wordpress.org/plugins/seo-by-rank-math/)
* [Yet Another Related Posts Plugin (YARPP)](https://wordpress.org/plugins/yet-another-related-posts-plugin/)
* [Yoast Breadcrumbs](https://wordpress.org/plugins/wordpress-seo/)
* [WooCommerce](https://wordpress.org/plugins/woocommerce/)

== License ==

Polestar WordPress Theme, Copyright 2017 Puro. Polestar is distributed under the terms of the GNU GPL.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/copyleft/gpl.html.

Polestar WordPress Theme is derived from [Underscores WordPress Theme](http://underscores.me/), Copyright 2012 Automattic. Underscores WordPress Theme is distributed under the terms of the GNU GPL.

== Images ==

Screenshot image "Half Dome Village, Yosemite Valley, United States" sourced from [Stocksnap.io](https://stocksnap.io/photo/mountain-landscape-P1LPBIJDEI) by [Billy Chester](https://stocksnap.io/author/43498) licensed under [CC0 1.0 Universal (CC0 1.0)](http://creativecommons.org/publicdomain/zero/1.0/).

== Fonts and Icons ==

The `polestar-icons` font family was created using IcoMoon and contains icons from Font Awesome.

`/inc/template-tags.php` contains SVG icons created using IcoMoon and includes icons from Font Awesome.

Font Awesome by Dave Gandy
Font released under the SIL OFL 1.1, CSS released under the MIT License
[Source](http://fontawesome.io)

== Bundled Resources ==

Customizer Library, Copyright Devin Price
Licensed under [GPL version 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
[Source](https://github.com/devinsays/customizer-library)

FitVids, Copyright 2013, [Chris Coyier](http://css-tricks.com) and [Dave Rupert](http://daverupert.com)
Released under the WTFPL license
[Source](https://github.com/davatron5000/FitVids.js/)

FlexSlider, Copyright 2012 WooThemes
Released under [GPL version 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
[Source](http://www.woothemes.com/flexslider/)

Normalize.css, Copyright Nicolas Gallagher and Jonathan Neal
Released under the [MIT License](http://opensource.org/licenses/MIT)
[Source](https://github.com/necolas/normalize.css/)

Puro Extras, Copyright Puro 2017
Released under [GPL version 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
[Source](https://github.com/purothemes/extras)

TGM Plugin Activation, Copyright 2011 Thomas Griffin
Released under [GPL version 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
[Source](https://github.com/TGMPA/TGM-Plugin-Activation)

== Changelog ==

= 1.9.1 - 08 November 2022 =
* WooCommerce: Updated bundled templates to `7.0.1`.

= 1.9.0 - 14 August 2022 =
* Updated Calendar Widget styling for new markup.
* Updated Customizer Library.
* WooCommerce: Added custom single product variation styling and functionality.

= 1.8.1 - 03 February 2022 =
* WooCommerce: Fixed single product variation drop-down alignment.
* Smooth Scrolling: Update to allow for animation interruption when another page jump is clicked.
* Footer Social Menu: Fixed last icon alignment.

= 1.8.0 - 05 December 2021 =
* Added additional web-safe fonts.
* FlexSlider: Prevented misalignment on load in SO Page Builder full-width stretched row.
* Logo Lazy Load Exclusion: Improved Jetpack plugin check.
* Scroll to Top: Adjusted to function when header has been removed.

= 1.7.0 - 22 July 2021 =
* Disabled WP 5.8 Block-Based widgets editor. Can be re-enabled using `add_filter( 'polestar_disable_new_widget_area', '__return_false' );`.

= 1.6.0 - 27 May 2021 =
* Updated logo lazy loading exclusion function.
* Updated featured image lazy load function.
* Minor adjustment to search results spacing.
* Improved the custom excerpt function.
* Added FitVids to the Block Editor.
* Updated Customizer Library.
* Developer: Added WooCommerce `polestar_display_mini_cart` filter to allow the mini-cart to be hidden when empty.
* Developer: Updated a theme JS function for jQuery 3.5 that was previously overlooked.

= 1.5.0 - 04 February 2021 =
* Added RankMath breadcrumb support.
* WooCommerce: Linked mini-cart View Cart hover color setting to `Accent Color`.
* WooCommerce: Improved Quick View gallery variation support.
* Developer: Added support for jQuery 3.5.

= 1.4.2 - 06 September 2020 =
* Added Block Editor support for Wide Alignment.

= 1.4.1 - 26 July 2020 =
* WooCommerce: Adjusted spacing for `No Products` notification.
* Minor code formatting enhancements.
* WooCommerce: Removed variation price negative margin on single product page.
* WooCommerce: Minor improvements for Variation Swatches for WooCommerce plugin
* WooCommerce: Updated `single-product-reviews.php` template to `4.3.0`.
* Main Menu: Ensured drop-down width handles additional content such as translation flags.
* Added new menu before and after action hooks. `polestar_menu_before` and `polestar_menu_after`.

= 1.4.0 - 16 February 2020 =
* Added a page Featured Image setting located at `Customize > Theme Settings > Pages > Featured Image`.
* Fixed header overlap light mobile menu cart icon color.
* Fixed overlap dark normal menu cart color.
* Minor WooCommerce archive button hover styling improvement.
* Minor WooCommerce widget styling improvements.
* One page menu: re-add current page indicator on scroll.

= 1.3.12 - 22 December 2019 =
* Resolved WooCommerce checkout overlay issue.

= 1.3.11 - 17 November 2019 =
* Don't display the page title if the header overlap is enabled unless there is a page featured image.
* Fixed Block Editor admin editor styles.
* Exclude the logo and featured images from Smush, LiteSpeed and Jetpack lazy loading.
* Don't load the breadcrumbs if header overlap is enabled.
* Minor code formatting enhancements.
* Jetpack Subscriptions minor styling fixes.
* Updated the sidebar widget area description.

= 1.3.10 - 30 September 2019 =
* Ensured FitVids targets `entry-video` for video post format.
* Changed sticky header height calculation to allow for re-calculation.
* Fixed smooth scroll sticky anchor when mobile menu in use.
* Minor about page and code formatting fixes.

= 1.3.9 - 02 September 2019 =
* Added new core `wp_body_open` hook.
* Minor WC product data tab styling adjustments.
* Updated Customizer Library.
* Added an early return for disabling header search close.
* Changed bottom bar item separators.

= 1.3.8 - 08 May 2019 =
* Removed WooCommerce mini-cart "Cart" title.

= 1.3.7 - 22 April 2019 =
* Updated WooCommerce single product reviews template to version 3.6.0.

= 1.3.6 - 26 March 2019 =
* Mobile Menu: Allow mobile users to open sub menu when mobile menu is disabled.
* Added Page Setting to Jetpack single projects.
* WooCommerce Mini-Cart: Updated deprecated `add_to_cart_fragments` to 'woocommerce_add_to_cart_fragments'.

= 1.3.5 - 18 March 2019 =
* Resolved Stripe payment gateway error message alignment.
* Adjusted page link styling for changed HTML structure.

= 1.3.4 - 09 March 2019 =
* Mobile Menu: Allow empty parent links to open the sub-menu.
* WooCommerce single product page responsive improvements.
* WooCommerce checkout payment options styling improvements.
* WooCommerce archives minor styling improvements.
* Removed Jetpack Responsive Videos. FitVids will now be allowed to run with Jetpack activated.
* Removed `polestarResetMenu` function not being used. Resolves a sub-menu width edge case issue.
* Adjusted element background colors slightly by introducing `$color__background-element`.

= 1.3.3 - 01 February 2019 =
* Logo scaling and sticky header sentinel improvements.
* Removed `h1` - `h6` tag clearing.
* Premium: Linked header widget styles to menu breakpoint.

= 1.3.2 - 06 January 2019 =
* Fixed missing WooCommerce cart cross-sells.
* Minor WooCommerce cart styling improvements.
* Minor WooCommerce checkout styling improvements.
* Improved logo scaling function.
* Slightly darkened default background and border colors for improved usability.
* Changed the page order of the title and featured images to match posts.

= 1.3.1 - 05 November 2018 =
* Prevented Jetpack Lazy Images from loading the logo image.
* Improved sticky header logo scaling.
* Fixed search icon SVG cut off in Firefox.
* Enqueued Gutenberg block editor style.

= 1.3 - 01 November 2018 =
* Prevented FitVids loading on Gutenberg pages.
* Added Gutenberg editor styles.
* Updated WooCommerce templates to version `3.5.0`.
* Added a setting for the footer privacy policy link located at `Customize > Theme Settings > Footer`.

= 1.2.10 - 24 September 2018 =
* Ensured the user set date format is respected in post meta.
* Updated the available Google Fonts array.
* Added the privacy page link to the bottom bar if a privacy page is selected.
* Added Jetpack Like compatibility.
* Updated the header search to close on click outside the container.
* Changed related posts date to `get_the_date`.
* Added WooCommerce check before adding the mini-cart.

= 1.2.9 - 28 June 2018 =
* Added a new WooCommerce mini-cart icon.
* Minor mobile menu style fixes.
* Minor WooCommerce style fixes.
* Added galleries to the WooCommerce Quick View modal.
* Improved search results design.

= 1.2.8 - 30 May 2018 =
* Resolved post slider function error when Jetpack not activated.

= 1.2.7 - 29 May 2018 =
* Updated WooCommerce review meta file for WooCommerce version `3.4.0`.
* Minor style adjustments.
* Overhauled excerpt function. `polestar_excerpt_length` and `polestar_unwind_excerpt_more` deprecated.
* Styled comment form cookie consent setting.

= 1.2.6 - 11 May 2018 =
* Corrected sidebar body class conditional statements.

= 1.2.5 - 11 May 2018 =
* Added styling for all WooCommerce core widgets that didn't have styling added previously.
* Minor styling updates for the WooCommerce checkout, login, dashboard and mini-cart.

= 1.2.4 - 05 May 2018 =
* Adjusted Jetpack Infinite Scroll to use posts per page setting.
* Minor Jetpack Infinite Scroll styling fixes.
* Added style support for the WooCommerce Price Filter widget.

= 1.2.3 - 28 March 2018 =
* Added WooCommerce grouped product styling.
* Fixed paragraph spacing in single WooCommerce product tab descriptions.
* Moved the viewport tag from `header.php` into `functions.php` to allow for easy removal.
* Removed the `responsive` body class no longer required.
* Updated searchform URL to prevent a 404 error when site and WordPress URL differs. 

= 1.2.2 - 22 March 2018 =
* Removed `polestarBurstAnimation not` being used.
* Minor WooCommerce single product page styling fixes.
* Added a step to ensure FlexSlider galleries don't flash on load.
* Removed duplicate WooCommerce actions.
* Added SiteOrigin layouts folder setup back. Page Builder should prevent error from occuring from version `2.6.3`.
* Fixed mobile menu icon color when header set to overlap and light text.
* Added WooCommerce grouped product styling.
* Added additional theme action hooks.

= 1.2.1 - 27 February 2018 =
* Temporarily removed the SiteOrigin layouts folder setup.

= 1.2 - 25 February 2018 =
* Added additional compatibility for Page Builder by SiteOrigin.
* Removed smooth scrolling from external page anchors.
* Minor WooCommerce styling fixes.

= 1.1.1 - 09 February 2018 =
* Updated WooCommerce template files to latest version.
* Minor styling fixes.

= 1.1 - 27 December 2017 =
* Added header overlap setting.
* Minor WooCommerce mini cart style fixes.

= 1.0.18 - 14 December 2017 =
* Resolved WooCommerce PayPal logo issue impacting child themes.

= 1.0.17 - 26 November 2017 =
* Fixed featured image setting on single post page.
* Minor style fixes for menu mini-cart.
* Gallery post format code enhancements. 

= 1.0.16 - 15 November 2017 =
* Resolved main menu mini-cart display problem.
* Minor styling adjustments.

= 1.0.15 - 14 November 2017 =
* Fixed author avatar issue on mobile.
* Fixed large logo bug on mobile.
* Minor code improvements.

= 1.0.14 - 30 October 2017 =
* Added support for WooCommerce products shortcode columns.
* Added comment moderation notification.

= 1.0.13 - 23 October 2017 =
* Resolved centered header layout bug.
* Minor code improvements.

= 1.0.12 - 19 October 2017 =
* Fixed mini-cart displaying in header on mobile.
* Updated mini-cart function.
* Updated WooCommerce reviews template to latest version.
* Prevented site description markup from outputting when field is empty.
* Changed header to flex-box to solve IE 11 bug.
* Minor code enhancements. 

= 1.0.11 - 11 October 2017 =
* Resolved Android footer scroll bug.

= 1.0.10 - 03 October 2017 =
* Updated comments navigation function.
* Removed core HTML5 searchform support.
* Minor code enhancements.
* Added a class for menu buttons.
* Fixed smooth scroll from mobile menu bug.
* Fixed one page menu item selection bug.
* Added tagline when setting is enabled and a logo has been added.

= 1.0.9 - 20 September 2017 =
* Minor code enhancements. 
* Added constrained page layout setting.
* Enabled keyboard accessibility for the header search icon.
* Updated Customizer Library to include Poppins Google Font.

= 1.0.8 - 13 September 2017 =
* Added support for the WooCommerce store notice.

= 1.0.7 - 25 August 2017 =
* Added minimal UberMenu support.
* Removed WooCommerce product hover buttons on mobile.
* Fixed WooCommerce content container width issues.
* Fixed WoooCommerce taxonomy page top spacing issue.
* Minor code style improvements.

= 1.0.6 - 28 July 2017 =
* Added Yelp icon as an option for the social icon footer menu.
* Fixed FlexSlider bugs when multiple sliders displayed on a single page.
* Fixed blog posts slider padding bug.
* Added Stripped page layout option. 
* Added WooCommerce demo store notice styling.
* Fixed WooCommerce Stripe payment gateway icon display.
* Fixed WooCommerce archive category display.

= 1.0.5 - 20 July 2017 =
* Added support for Jetpack Related Posts.
* Minor WooCommerce style fixes.

= 1.0.4 - 12 July 2017 =
* Fix missing CSS icons.

= 1.0.3 - 11 July 2017 =
* Added posts slider as loop file to used with Page Builder by SiteOrigin Post Loop widget.
* Resolved mobile menu scroll bug.
* Minor WooCommerce style fixes.

= 1.0.2 - 03 July 2017 =
* WooCommerce style improvements for Add to Cart button and login form.
* Comment reply style improvements.
* Added support for Max Mega Menu plugin.

= 1.0.1 - 13 June 2017 =
* Added overflow to WooCommerce mini-cart to ensure all products can be viewed when cart has many items in it.
* Expanded Page Settings to include posts.
* Added Full Width No Sidebar page layout option to accommodate non-SiteOrigin Page Builders.

= 1.0.0 - 04 June 2017 =
* Added WooCommerce product Quick View.
* Added Customizer settings for Quick View and Add to Cart buttons on product hover. WooCommerce settings only appear if WooCommerce is activated. 

= 0.9.9 - 22 May 2017 =
* Improved WooCommerce archive page type responsive behaviour.
* Updated WooCommerce gallery to slideshow and lightbox.
* Added setting for all WooCommerce gallery combinations.
* Small style adjustments to WooCommerce Cart, Checkout and Order Received pages.

= 0.9.8 - 16 May 2017 =
* Improved WooCommerce mini-cart styling. Fixed hover area bug.
* Added WooCommerce shop archive columns setting.

= 0.9.7 - 04 May 2017 =
* Added ability to close header search using the escape key.
* Fixed table cell border color.
* Minor style adjustments to buttons and the blog posts slider.
* Added WooCommerce mini cart and related setting.

= 0.9.6 - 16 April 2017 =
* Fixed incorrect Sass partial imports for Flexslider and the blog posts slider.
* Fixed mobile search field missing border.
* Fixed related posts Customizer default value.
* Updated WooCommerce template files.
* Refactored content padding to allow the footer margin page setting to function properly.

= 0.9.5 - 09 April 2017 =
* Added About page.
* Added plugin recommendations.
* Added WooCommerce Customizer settings.
* Added Page Settings.
* Added new Customizer settings.

= 0.9.4 - 09 March 2017 =
* Added readme.txt to release build.

= 0.9.3 - 09 March 2017 =
* Added internationalization to footer copyright text date.
* Added missing escaping of links.
* Changed to core WP function for single post navigation.
* Optimized related posts function.
* Added missing prefix to theme menu JavaScript.

= 0.9.2 - 27 February 2017 =
* Changed the mobile menu collapse default to 768px.
* Corrected Footer Text setting description.
* Updated screenshot.

= 0.9.1 - 11 February 2017 =
* Various changes and improvements for release.

= 0.9 - 25 November 2016 =
* Initial release.