← All posts

Manually Patch Oxygen Builder for Oxywind (Winden)

winden

Oxywind has to patch Oxygen Builder before the two work together. When the automatic patch doesn't run, for example right after you install an Oxygen beta, you're stuck. This video shows the manual patch: download the patch files for your Oxygen version and merge them into the Oxygen plugin folder. It takes about a minute, on Mac or Windows.

Note: Oxywind is now called Winden.

Why the automatic patch can fail

Normally you patch from Oxygen → Oxywind, on the License tab. In the Setup section, you click the Patch now! link. The Oxywind docs explain that if your server doesn't have the PHP exec function enabled, or Git isn't installed, the Patch now! link is disabled or hidden. When that happens, use the Manual Patching section of the docs instead.

Download the right patch files

The patch files are specific to your Oxygen version, and the wrong ones won't work. The docs list one download for each version: Oxygen Builder 4.0 Beta 1 and Oxygen Builder 4.0 Beta 2. To check which version you have, look at Oxygen Builder version in the Oxywind Setup section. In the video it shows 4.0 Beta 2, so we use 4.0-beta-2.zip.

The unzipped patch follows the same folder layout as the Oxygen plugin:

oxygen/
├── component-framework/
│   ├── angular/
│   │   └── controllers/
│   │       ├── controller.classes.js
│   │       ├── controller.css.js
│   │       └── controller.main.js
│   └── components/
│       └── component.class.php
└── oxywind.patched

Patching on Mac: choose Merge, not Replace

On a Mac, the obvious move deletes files. If you paste the patch's oxygen folder over the plugin's oxygen folder and choose Replace, Finder keeps only the patch files and deletes the rest of Oxygen.

  1. Unzip the patch file.
  2. Copy the oxygen folder from the patch.
  3. Paste it into wp-content/plugins, where the Oxygen oxygen folder already is.
  4. When Finder asks, click Merge. Your existing folder structure stays and only the patched files are overwritten.
  5. Refresh the Oxywind settings page. Is Patched? should now say Patched.

In the video we repeat this on a fresh Oxygen install. Before the merge, the settings page shows the site as not patched. After the merge and a refresh, it shows Patched.

Patching on Windows: copy each file into place

Windows doesn't offer the same merge option, so you copy the files one by one into the matching Oxygen folders. We didn't test this on Windows in the video. The steps just follow the folder structure:

  1. Copy oxywind.patched into the root of the oxygen plugin folder.
  2. Copy component.class.php into oxygen/component-framework/components/ and replace the existing file.
  3. Copy controller.classes.js, controller.css.js and controller.main.js into oxygen/component-framework/angular/controllers/ and replace the existing files.

Keep Oxygen's folder structure exactly as it is and only replace these files. Then the patch will apply.

Oxywind is now Winden → dplugins.com

Related posts