Renewing License Keys

Renewing License Keys

Renewing your license key gives you continued access to GP Premium downloads and our premium support forum.

If your license key is expired, you can renew it by accessing your account and clicking the Renew now or Renew license links.

If your license hasn』t expired yet, but you want to extend it by a year, you』ll see an Extend license link instead.

Extending your license will extend it one year from the expiration date.

After Renewing the License Key

Your license key won』t change during the renewal process. Once your license is renewed, make sure that the automatic update is still activated then you are good to go!

Upgrading License Keys

Upgrading License Keys

If you already own a yearly license key, you can choose to upgrade to our lifetime plan in your account.

Our lifetime license includes:

Lifetime updatesLifetime premium supportUse on up to 500 websites

The cost of this upgrade is the current cost of the lifetime license minus the amount you paid originally. This does not include any renewals you』ve paid for.

For example, if you paid $49.95 for your license, and the lifetime license is $249, you would pay $199.05 for your upgrade.

500 Activation Limit

If you』re upgrading from an old license with unlimited license activations, it will change to our 500 license activation limit if you upgrade to the lifetime license. This is intended, as having a cap on license key activations helps prevent license-reselling and other bad things.

This limit cannot be changed. If you have over 500 websites, you will have to invest in another license key in order to add more.

Updating Issues

Updating Issues

Update package not available

Updates can only process if your license key is activated.

To activate your license key, go to Appearance > GeneratePress in your Dashboard, and add it into the license key field on the right.

Getting an unauthorized message

When you activate your license, the URL you』re activating it from is authorized on our end.

If that URL changes at any time, you need to re-authorize your license key or you』ll received an 「unauthorized」 error when trying to update.

To re-authorize your license key, go to Appearance > GeneratePress and click the Save button under your license key field.

Download failed. cURL error 51

An error occurred while updating GP Premium: Download failed. cURL error 51: SSL: certificate subject name 『docs.generatepress.com』 does not match target host name 『generatepress.com』

If you』re receiving the above message, it means your server is using a very old version of CURL and/or OpenSSL. To fix this, your server needs to update both your SSL library and CURL.

Yoast.com has an excellent article on this which goes into more detail here.

Email activation failed

Our email activation system was being bombarded by spam, so we had to switch back over to license keys. If you never activated your email, you』ll have to manually update to the latest version in order to activate your license key and get updates through your Dashboard.

Could not copy file

Also seen as 「could not create directory」.

This error can happen for two reasons.

If you』re using your localhost running on a Windows machine. For whatever reason, there』s a bug between the WordPress updating system and Windows hosting. You can read the more technical aspects of this issue here. To fix this issue, you can use this plugin.If you』re using a live server that』s not Windows based, it』s likely that some of the file/folder permissions are not what they should be. Contact your hosting and ask them to make sure that you』re able to upload/remove/change files on your server through WordPress.

Manually updating

If all else fails, you can always manually update.

You won』t lose any of your settings this way – it』s the same process that happens when you update via the Dashboard, it just takes a few minutes longer.

Installing GeneratePress

Installing GeneratePress

Installing GeneratePress is super easy.

First, login to your WordPress Dashboard.

Next, go to 「Appearance > Themes」 in the menu on the left.

Near the top, you』ll see a 「Add New」 button, click that button.

In the 「Search themes」 bar, type: generatepress

You』ll see GeneratePress and some of our child themes appear.

Click 「Install」, and then activate.

Installing GP Premium

Installing GP Premium

Install GeneratePress

The first step you need to do is installing GeneratePress. GeneratePress is the free theme which is required to be installed and activated in order to use GP Premium (plugin).

Download GP Premium

To find your download links, go to your account.

Click or right-click the download button (control + click for Mac users), then save the file to your computer. The file should save as gp-premium.zip.

Using Firefox or Chrome, the option you want to click is 「Save link as…」.In Safari, it』s 「Download linked file as…」.In Internet Explorer, it』s 「Save target as…」.

Note for Mac users who are using Safari: If your download appears as an ordinary folder instead of a zip file, go to 「Safari Preferences > General」 and uncheck 「Open 『safe』 files after downloading」. Then the download will remain a zip file and not be unpacked.

Add GP Premium to your website

From your Dashboard, go to Plugins > Add New.

Click  Upload Plugin at the top, browse and select the gp-premium.zip file.

Activate your modules

Now navigate to 「Appearance > GeneratePress」 and activate the individual modules you wish to use on your site.

Please note that WooCommerce plugin itself needs to be installed and activated before GP』s WooCommerce module can be activated.

Activating your license key for automatic updates

For instructions on activating your license key, please see this article.

Updating GP Premium

Updating GP Premium

GP Premium updates contain bug fixes and new features. You can check what version you』re running in Appearance > GeneratePress or in the Plugins area of your Dashboard.

In order to receive updates through your Dashboard, you need to activate your license key.

Finding Your License Key

To find your license key, go to your account and locate your download.

Copy your license key and move onto the next step.

Activating Updates

Now that we have our license key copied, we can navigate to 「Appearance > GeneratePress」 in our Dashboards.

Paste your license key into the license key field, and click the 「Save」 button.

Problem activating? See this article.

Manually Updating

Sometimes the update process through your Dashboard won』t work due to server restrictions. In that case, you can manually update.

Download a fresh copy of your add-on through your account.Upload and activate the fresh copy you downloaded in step 1.

GeneratePress and GP Premium

GeneratePress and GP Premium

GeneratePress – Free Theme

Latest Version: 3.1

Your installed Version: Check Appearance > Themes.

How to Install: Through Appearance > Themes. Details

How to Update: Through Appearance > Themes. Details

Free Support Forum

GP Premium – Premium Plugin

Latest Version: 2.1.1

Your installed Version: Check Dashboard > Plugins.

How to Install: Through Dashboard > Plugins. Details

How to update: Auto-update when activated. Details

Premium Support Forum

generate_svg_icon_element

generate_svg_icon_element

The generate_svg_icon_element filter allows change the default icons used throughout the theme.

The available options are:

menu-bars
close
search
categories
tags
comments
arrow
arrow-right
arrow-left
arrow-up

For example, if you want to use a custom navigation search icon to replace the default one, then this function can be used:

add_filter( 'generate_svg_icon_element', function( $output, $icon ) {
if ( 'search' === $icon ) {
$output = 'Your-custom-search-icon';
}
return $output;
}, 10, 2 );

Make sure to only replace your-svg-here with the actual SVG code in the snippet above.

generate_element_display

generate_element_display

The generate_element_display allows us to bypass the Display Rules, so we can enable or disable an Element under our own conditions.

This filter replaces the previous generate_header_element_display, generate_hook_element_display and generate_layout_element_display.

Display an Element to a Specific Author

For example, if we want to assign a specific element to Author Tom only:

add_filter( 'generate_element_display', function( $display, $element_id ) {
if ( 100 === $element_id && is_author( 'Tom' ) ) {
$display = true;
}

return $display;
}, 10, 2 );

You need to replace 100 with the ID of your Element.

Display an Element to a Parent Page and All Child Pages

Another useful example is to set the hook to display on the parent page and all the child pages automatically:

add_filter( 'generate_element_display', function( $display, $element_id ) {
global $post;

if ( 1180 === $element_id && ( is_page() && $post->post_parent == '415' ) ) {
$display = true;
}

return $display;
}, 10, 2 );

You need to replace 1180 with the ID of your Element, and 415 with the ID of the parent page.

Display an Element to the First Page of Archives Only

Another request that we get from time to time is to only show page hero on the first archive or posts page and turn off for 2nd and subsequent pages of posts. This can be done with the snippet below:

add_filter( 'generate_element_display', function( $display, $element_id ) {
if ( 100 === $element_id && is_paged() ) {
$display = false;
}

return $display;
}, 10, 2 );

You need to replace 100 with the ID of your Element.

Remove an Element when No Featured Image is Uploaded

If you would like to remove a block element page hero automatically when no featured image is uploaded instead of using the display rules manually, this snippet can be used:

add_filter( 'generate_element_display', function( $display, $element_id ) {
if ( 100 === $element_id ) {
if ( ! has_post_thumbnail() ) {
$display = false;
}
}

return $display;
}, 10, 2 );

You need to replace 100 with the ID of your Element.

Replicating the Screenshot

Replicating the Screenshot

Replicating our theme screenshot using the free version of GeneratePress is super easy. This article will go through the necessary steps.

The Content

We used the block editor along with our very own free block plugin, GenerateBlocks, to build our content. However, you can achieve the same look with the core blocks if you want.

If you want to use GenerateBlocks (highly suggested), you should install it and then download the content file below.

Download Demo Homepage

This will import a page named 「Home」 to your website. You can now see it in the 「Pages」 area of your website.

Set the Front Page

The first thing we need to do is set a static front page. By default, WordPress will use the posts page (blog) as your front page.

Using the page we imported above (or your own custom page if you want), go to 「Settings > Reading」 and set the 「Front page displays」 option to 「A static page」, and choose the page you imported/created.

Adding the Logo

Next, we』ll add the logo to our site. You can learn how to add your logo to GeneratePress in this article.

Creating the Menu

We created our menu inside WordPress (see these instructions), and then activated the navigation search option in Customize > Layout > Primary Navigation.