Home / / How to Update WPResidence Theme & Included Plugins

How to Update WPResidence Theme & Included Plugins

15801 views
This video shows how to update WPResidence with the Envato Market plugin, the method for ThemeForest licenses. With a wpresidence.net license, the update appears in Dashboard > Updates, as explained below. Watch Video on Youtube

An update replaces the WPResidence theme files and the files of the included plugins. Your pages, properties, users, media and Theme Options settings are stored in the database and stay as they are.

CONTENT

Before you update

  • Back up the site: the WordPress files and the database, from your hosting panel or with a backup plugin.
  • Keep custom code in a child theme. An update replaces the parent theme files, so code edited inside the wpresidence folder is lost. See How to install a child theme.
  • Translations. Translations in the child theme are kept. After the update, sync them to find the new texts: Translate WPResidence.
  • Read the changelog to see what the new version changes: WPResidence Change Log.
  • Use a staging copy first if the site is live and customized.

Update the theme

How you update depends on where you bought WPResidence.

Where you bought it How you update
wpresidence.net Dashboard > Updates, after you register the license key
ThemeForest Envato Market plugin, connected with your Envato account

With a wpresidence.net license

  1. Register your license key in WPResidence Site Settings > WPResidence License. Where to find the key: Get your license code and register it.

WPResidence Site Settings > WPResidence License tab with a registered wpresidence.net license

  1. Open Dashboard > Updates when a new version is out. WPResidence is listed under Themes. Select it and click Update Themes. The update also shows under Appearance > Themes.

Dashboard > Updates showing a new WPResidence theme version ready to update

WPResidence checks for a new version twice a day. The Envato Market plugin is not needed.

Updates are included while your subscription is active. If you cancel the renewal, the site keeps working and updates stop when the paid period ends. See Invoices, subscription and cancelling the renewal.

With a ThemeForest license (Envato Market plugin)

  1. Install the Envato Market plugin from envato.com/market-plugin, or from Appearance > Install Plugins.
  2. Create an Envato personal token. Open Envato Market in wp-admin and follow the token link. Keep the permissions the plugin lists, give the token a name and create it. Use the Envato account that bought WPResidence.
  3. Paste the token in the Token field and click Save Changes. The plugin confirms that the token is verified and lists WPResidence.

Envato Market plugin settings with the Envato API personal token field

  1. Click Update next to WPResidence on the Envato Market Themes tab when a new version is available.

Manual reinstall

  1. Download the latest wpresidence.zip.
    • wpresidence.net license: care.wpestate.org > My Licenses > Download theme.
    • ThemeForest license: Downloads > Installable WordPress file only.
  2. Activate another theme for a moment in Appearance > Themes, then delete WPResidence.
  3. Upload the new wpresidence.zip in Appearance > Themes > Add New > Upload Theme, then install and activate it.

Appearance > Themes > Upload Theme screen for installing wpresidence.zip

Update the included plugins

Update the included plugins right after the theme. The theme and WPResidence Core Functionality work as a pair: an old core plugin with a new theme causes missing options, broken widgets or PHP errors. The included plugins need no separate license; their updates come with the theme.

Go to Appearance > Install Plugins, select the plugins marked Update Available and update them.

Appearance > Install Plugins screen listing the WPResidence bundled plugins

To update one plugin by hand:

  1. Download the full package.
    • wpresidence.net license: care.wpestate.org > My Licenses > Download WP Residence package.
    • ThemeForest license: Downloads > All files and documentation.
  2. Unzip it and open the plugins folder.
  3. Deactivate and delete the old plugin in Plugins.
  4. Upload the plugin zip in Plugins > Add Plugin > Upload Plugin and activate it.

Plugins > Add Plugin > Upload Plugin screen for installing a plugin zip

If you need a plugin update before the next theme release, open a ticket on care.wpestate.org.

After the update

  1. Clear every cache: CDN, hosting, cache plugin, the WPResidence cache and the browser (or test in an incognito window).
  2. Check Appearance > Install Plugins for plugin updates still pending.
  3. Test the main pages: homepage, a property page, search results, the user dashboard and a contact form.

Common problems

The site looks broken, or options and widgets are missing

Clear all caches and check that WPResidence Core Functionality and WPResidence Elementor Addon are updated in Appearance > Install Plugins.

Code changes were lost

The update replaces the parent theme files. Restore your code from the backup and move it to a child theme: How to install a child theme.

The update does not show

  • wpresidence.net license: check that the license is registered in WPResidence Site Settings > WPResidence License and wait up to 12 hours for the next check.
  • ThemeForest license: check that the Envato token is valid and was created with the Envato account that bought WPResidence.
  • Both: use the manual reinstall.

WordPress says the destination folder already exists

The old wpresidence folder is still on the server. Use the automatic update, or activate another theme, delete WPResidence and upload the new zip again.

Leave a Reply