Title: Naroum Update Merge
Author: maximebakernsn
Published: <strong>30 سپتامبر 2026</strong>
Last modified: 30 سپتامبر 2026

---

جستجوی افزونه‌ها

![](https://s.w.org/plugins/geopattern-icon/naroum-update-merge.svg)

# Naroum Update Merge

 توسط [maximebakernsn](https://profiles.wordpress.org/maximebakernsn/)

[دانلود](https://downloads.wordpress.org/plugin/naroum-update-merge.1.0.0.zip)

 * [جزئیات](https://fa.wordpress.org/plugins/naroum-update-merge/#description)
 * [نقد و بررسی‌ها](https://fa.wordpress.org/plugins/naroum-update-merge/#reviews)
 *  [نصب](https://fa.wordpress.org/plugins/naroum-update-merge/#installation)
 * [توسعه](https://fa.wordpress.org/plugins/naroum-update-merge/#developers)

 [پشتیبانی](https://wordpress.org/support/plugin/naroum-update-merge/)

## توضیحات

Editing a third-party plugin is sometimes the only way to get what a client needs.
The problem comes with the next update: installing it overwrites your changes, and
skipping it leaves security fixes behind.

Naroum Update Merge solves this with a three-way merge, the same approach version
control tools use. It compares:

 * the **original version** your changes were made on,
 * **your customized version**, currently installed,
 * the **new version** of the plugin.

Because it knows the original, it can tell what you changed from what the update
changed:

 * Files and lines changed only by you are kept automatically.
 * Files and lines changed only by the update are applied automatically.
 * Changes on both sides in different places are merged line by line.
 * Only real conflicts, where both sides changed the same lines, are shown to you.

For each conflict you choose which code to keep: my version, the new version, both(
in either order), or the original version. The tool only combines code that already
exists in these versions; it does not let you type code. To adjust the result by
hand, download the merged ZIP, edit it, and install it with Plugins > Add New > 
Upload Plugin.

#### Safe installation

 * ZIP backup of the installed plugin before anything is replaced, downloadable 
   from the tool.
 * PHP syntax check of every file that comes from your version or from a merge. 
   Installation is blocked on error.
 * Installation is blocked if the plugin changed on the server since the analysis.
 * The plugin folder is swapped with two renames on the same disk, with automatic
   rollback if the second one fails.
 * The new release is saved as the reference for your next update, so you only need
   to provide the original version once.
 * Prefer to install manually? Download the merged plugin as a ZIP instead.

#### Sources

 * Original version: downloaded from WordPress.org (matching the installed version
   number), uploaded as a ZIP, or the reference saved by the previous merge.
 * New version: latest release from WordPress.org, or uploaded as a ZIP (premium
   plugins, specific versions).
 * No original version available? A two-way comparison lets you choose every difference,
   with a bulk action for the files you did not touch.

#### Who is it for?

Agencies and developers who maintain client sites with customized plugins and want
a reviewable, reversible update process instead of redoing their changes by hand.

The tool is available under Plugins > Update Merge, to users who can install and
update plugins. It is unavailable when `DISALLOW_FILE_MODS` is set. On multisite,
it is in the network admin.

### External services

This plugin connects to WordPress.org only when you choose a WordPress.org source
in the analysis form. Nothing is sent automatically or in the background.

 * `api.wordpress.org` (Plugins API) is queried with the plugin slug to find the
   download link of the latest release.
 * `downloads.wordpress.org` is used to download the latest release, or the original
   release matching the installed version number.

No personal data is sent. Only the plugin slug and version number are part of the
requests. WordPress.org [Terms of Service](https://wordpress.org/about/tos/) and
[Privacy Policy](https://wordpress.org/about/privacy/).

## نصب

 1. Install and activate the plugin through the Plugins screen, or upload the `naroum-
    update-merge` folder to `/wp-content/plugins/`. On multisite, network activate 
    it.
 2. Go to Plugins > Update Merge.
 3. Select the customized plugin, the source of the original version and the source
    of the new version, then click Analyze.
 4. Review the files to resolve, choose your blocks, then download the merged ZIP or
    install it on the site.

## سوالات متداول

### Where are the working files stored?

In `wp-content/uploads/naroum-update-merge/`: ongoing analyses (deleted after 3 
days), backups and saved references. The folder is protected with an `.htaccess`
file and random folder names. On Nginx, add a rule denying access to this path. 
Everything is removed when you delete the plugin.

### What if my host requires FTP credentials to install plugins?

Direct installation is disabled in that case. Download the merged ZIP and install
it from Plugins > Add New > Upload Plugin.

### How do I restore a backup?

Download it from the Backups section of the tool, then upload it from Plugins > 
Add New > Upload Plugin and choose to replace the current version.

### Does it handle single-file plugins?

No. Only plugins installed in their own folder are supported.

### My changes were overwritten by an automatic update.

Disable automatic updates for customized plugins on the Plugins screen. After each
installation, the tool reminds you to check this setting.

### Can I limit the archive size?

Yes, with the `naroum_um_max_unzipped_bytes` filter (500 MB by default).

## نقد و بررسی‌ها

نقد و بررسی‌ای برای این افزونه یافت نشد.

## توسعه دهندگان و همکاران

“Naroum Update Merge” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.

مشارکت کنندگان

 *   [ maximebakernsn ](https://profiles.wordpress.org/maximebakernsn/)

[ترجمه “Naroum Update Merge” به زبان شما.](https://translate.wordpress.org/projects/wp-plugins/naroum-update-merge)

### علاقه‌ مند به توسعه هستید؟

[کد را مرور کنید](https://plugins.trac.wordpress.org/browser/naroum-update-merge/)،
[مخزن SVN](https://plugins.svn.wordpress.org/naroum-update-merge/) را بررسی کنید،
یا از طریق [RSS](https://plugins.trac.wordpress.org/log/naroum-update-merge/?limit=100&mode=stop_on_copy&format=rss)
در [گزارش توسعه](https://plugins.trac.wordpress.org/log/naroum-update-merge/) مشترک
شوید.

## گزارش تغییرات

#### 1.0.0

 * Initial release.

## اطلاعات

 *  نگارش **1.0.0**
 *  آخرین به‌روزرسانی **10 ساعت پیش**
 *  نصب‌های فعال **کمتر از 10**
 *  نگارش وردپرس ** 5.5 یا بالاتر **
 *  آزمایش‌شده تا **7.1.2**
 *  نگارش PHP ** 7.4 یا بالاتر **
 *  زبان
 * [English (US)](https://wordpress.org/plugins/naroum-update-merge/)
 * برچسب
 * [customization](https://fa.wordpress.org/plugins/tags/customization/)[developer](https://fa.wordpress.org/plugins/tags/developer/)
   [diff](https://fa.wordpress.org/plugins/tags/diff/)[merge](https://fa.wordpress.org/plugins/tags/merge/)
   [update](https://fa.wordpress.org/plugins/tags/update/)
 *  [نمایش پیشرفته](https://fa.wordpress.org/plugins/naroum-update-merge/advanced/)

## امتیازها

هنوز هیچ نقدی ارسال نشده است.

[بررسی شما](https://wordpress.org/support/plugin/naroum-update-merge/reviews/#new-post)

[مشاهدهٔ همهٔ بررسی‌ها](https://wordpress.org/support/plugin/naroum-update-merge/reviews/)

## مشارکت کنندگان

 *   [ maximebakernsn ](https://profiles.wordpress.org/maximebakernsn/)

## پشتیبانی

چیزی برای گفتن دارید؟ نیاز به کمک دارید؟

 [مشاهده انجمن پشتیبانی](https://wordpress.org/support/plugin/naroum-update-merge/)