WP All Import 文档

Image Options

The Images section in WP All Import provides multiple options to better control how and when your images are imported. The available options will vary based on which source you've chosen for your images.

Search through the Media Library for existing images before importing new images

This option attempts to match previously imported images by either URL or filename based on your selection. If no previously imported image is found the image is downloaded and passed to WordPress for processing. Then it's linked to the record.

Keep images currently in Media Library

When this option is unchecked WP All Import will first delete every image attached to the record being processed. Then it will proceed through the other options as usual. If your images change at the source without having their names or URLs updated in your file, you'll need to uncheck this box to ensure the latest versions are always downloaded. Note: If this option is unchecked the option to 'Skip posts if their data in your file has not changed' (Manage Imports > Import Settings) will be disabled.

Scan through post content and import images wrapped in tags

<img width="1024" height="138" src="https://www.wpallimport.com/wp-content/uploads/2021/10/scan-through-post-content-1024x138.png" alt="Scan through post content and import images wrapped in

This will search through whatever you've provided in the Content/Description field and import any images that are wrapped in tags. Once the images are imported the tags will be updated to point to the local image. Note: the image URLs must be absolute such as https://yoursite.com/yourimage.png and not /yourimage.png

Other Image Options

Importing Images From URLs

Choose the option Download image(s) hosted elsewhere to import images from a URL starting with http:// or https://.

Drag & drop the element or attributes containing your image URLs or filenames to the text box.

Image URL Elements

Use the Preview & Test button to see the final URLs that WP All Import will attempt to download your images from.

If your images are not importing as expected, the cause is almost always that the URLs you specified don』t actually point to valid images.

Make sure one complete image URL is present on each line, or that your complete image URLs are separated by the separator character you specify.

Example 1 – Constructing Image URLs from File Names

If your XML or CSV file only contains the image file name, not the complete URL to the file, you』ll have to construct the URL to your file by prepending the image file name with the URL to the folder containing it.

In your file: my-image-name.jpgImage URL: http://example.com/my-folder/my-image-name.jpg

Static Text Plus Elements

Example 2 – Importing From Attributes

If your images are in an attribute and not an element, make sure you click and drag the attribute, not the element. Attributes only exist in XML files.

What is an attribute?

If your image URLs are stored in attributes, not elements, click and drag `attribute` to the image URLs textbox, not `element`.

Example:

Drag `url` to the image URLs textbox, so the textbox contains {img[1]/@url}, not just {img[1]}.

Overview

WP All Import provides a number of options for sideloading images to the posts it creates. Watch the video below for an overview of a few different ways to import images.

When creating a new import, you can specify the settings for importing your images in Step 3. To add images to an existing import, go to Manage Imports -> Edit Import.

For each record in your file, WP All Import will create a post, import the images associated with that record to the post』s Media Gallery, and optionally set the Featured Image.

Meta Data

WP All Import can import image meta data from your file to WordPress. The possible meta fields are Title, Caption, Alt Text, and Description – as shown in the image below.

Image Meta Data Edit View

Image meta data can be imported in the SEO & Advanced Options sub-section of the Images section in WP All Import.

Meta data will be associated with images based on the order of the images and order of the meta data – for example, the first caption will be associated with the first image, the second caption will be associated with the second image, and so on.

Image Meta Data

Variable Number Of Images Per Host

Sometimes, each record in your XML or CSV file will have a different number of images associated with it. Here are some of the most common ways to handle this scenario with WP All Import.

Option A: Image URLs Are Stored In A Single Column Or Element, And Separated By A Character

Simply drag & drop the column or element containing your image URLs or filenames to the appropriate textbox, and enter in the appropriate Separator character if it is different than a comma.

Drag and drop single element

Option B: Image URLs are Contained In Different CSV Columns or XML Elements

WP All Import will ignore any blank image URLs, so you can simply specify all possible XPaths that could potentially point to image URLs for certain records. Any that don』t point to image URLs for the current record will be ignored for that record.

1. Go to the record in your XML or CSV file has the most images in the XML/CSV tree on the right, by entering in the record number and then clicking anywhere on the XML/CSV tree:

XML Tree View

2. Drag & drop all the elements or columns containing image URLs into the image URLs box.

Multiple image elements

Although you can』t see it in the screenshot, in our example, record 179 has 9 different images.

No other records have 9 different images, they have between 1 and 8. WP All Import will simply ignore {image_9[1]} when it doesn』t exist, {image_8[1]} when it doesn』t exist, etc.

Option C: Use an XPath query or a FOREACH Loop

If all your image URLs are stored as child elements of some parent element, you can use a FOREACH loop to loop through each child element.

This is only applicable to XML files.

Example XML:

Featured Image
Second Image
Third Image
Fourth Image

You can use this XPath query to output a comma delimited list of the image names:

{images/image/@src}

Or, if you need to prepend a URL, or add something else to the data, you can use a FOREACH loop instead:

[FOREACH({images/image})]http://www.example.com/my-folder/{@src},[ENDFOREACH]

More information on FOREACH loops.

How to Schedule WordPress Exports

WP All Export allows you to re-run an export automatically on a schedule. You may need to re-run an export when you have new data (such as orders, users, or comments), when you need to sync product stock data, or when you need to sync two sites together, etc.

WP All Export uses cron jobs to automate exports. You can manually create these cron jobs, or you can also use our Automatic Scheduling, which is a paid and optional service.

WP All Export can also use Zapier to connect with different applications and process exported data more efficiently. This integration comes built-in.

Automatic Scheduling Service

Optional paid service that's integrated directly within WP All Export and allows to easily schedule exports.

Manual Scheduling

Learn how to manually create the cron jobs required for exports to run on a schedule.

How to Let Clients Run WordPress Exports

Client Mode in WP All Export allows admins to provide access to a limited, secure interface for selected user roles. Users with access to Client Mode can run exports and download export files for the exports made available to them.

By default, exports are only available to admins and are only available to non-admins when specifically added to Client Mode by an admin.

Enable Client Mode for Specific Exports

Client Mode can be enabled in Manage Exports › Export Settings.

It can also be enabled in All Export › Manage Exports from the Bulk Actions pulldown.

Enable Access to Client Mode

Go to the WordPress admin panel, then select All Export › Settings.Scroll down to Client Mode and select role select roles with access.

Giving a role access to Client Mode affects all user accounts with that role. They will have access to a limited part of WP All Export and will be able to run and download all exports that have been added to Client Mode.

What Clients See

For testing purposes, you can create an account for yourself and grant access to it. When going into WP All Export as a non-admin, users see a list of exports that you have given them access to.

This is how the Manage Exports page looks using Client Mode.

Client Mode and Security

Client Mode was built with security in mind. Users cannot edit any settings related to exports. They can only access exports that admins specifically allow. With exports they have access to, they can run exports, download the data, and nothing else.

Export WordPress Categories and Tags to CSV or XML

To export WordPress categories and tags go to WP All Export › New Export and select which type of taxonomies to export. Then, drag and drop your taxonomy data to set up your export file. WP All Export will automatically detect all custom taxonomies and term data.

Understanding WordPress Taxonomies

Taxonomies are used in WordPress to group posts, products, and other post types together based on relationships. By default, WordPress posts have two taxonomy types: Categories and Tags.

Plugins and themes can also add their own custom taxonomies. For example, a real estate plugin might create a custom taxonomy called Property Type, with terms like House and Apartment. An e-commerce plugin might create a custom taxonomy called Brand, with a separate term for each brand of product available.

Read more about WordPress taxonomies: https://wordpress.org/support/article/taxonomies/

Exporting Taxonomies Directly vs Exporting Posts with Their Taxonomy Data

WP All Export offers two ways to export taxonomy data: export the posts with just the term name, or export taxonomies directly with all of the term data but without the posts they are attached to.

This guide focuses on exporting taxonomies and term data directly.

Select Taxonomies to Export

Go to WP All Export › New Export, select Taxonomies, and then select which taxonomy to export from the drop-down list. Here you can see the custom taxonomies added by WooCommerce:

Export WordPress Term Meta

Taxonomies are divided into three sections in Available Data: Standard, Media, and Term Meta.

The Standard section contains the most commonly used term meta.

Term ID: The term ID, assigned by WordPressTerm Name: The term's name, which is displayed most commonly on the frontend and in the WordPress admin areaTerm Slug: The term's slug, a database-friendly version of the nameDescription: A description of the term, similar to a post's contentParent ID: The ID of the parent term that this term is a child ofParent Name: The name of the parent termParent Slug: The slug of the parent termCount: The number of posts that are attached to this term

Export WordPress Taxonomy Images

The Media section contains the images or thumbnails added to your taxonomy.

Taxonomies don't have images by default, but this functionality can be added by other plugins. For example, WooCommerce enables thumbnails for its product categories. Exporting WordPress taxonomy images works just export post images.

Read more about how to export images from WordPress: https://www.wpallimport.com/documentation/export-wordpress-images/

Export WordPress Term Meta

The Term Meta section contains any other custom metadata added to your taxonomies by your theme and plugins. Term meta is automatically detected.

A Complete WordPress Taxonomy Export

After dragging and dropping the term meta and organizing your export, click the Preview button to see how your file will look.

How to Export WordPress to CSV, Excel, or XML

WP All Export exports WordPress to CSV, Excel, and XML. Each file type can be easily configured to meet pretty much any format, schema, or structure.

Drag & drop to rearrange and rename columns in CSV and Excel exports. Columns can be combined, and data passed through PHP functions. You can even change the delimiter to create TSV files, or whatever is required.

When exporting to XML you can drag & drop to create a simple feed. For more complicated XML schemas, WP All Export uses a simple syntax that allows you to directly write out the format that you need in XML.

Export WordPress to CSV and Excel

Export WordPress to CSV, TSV, XLS, and XLSX.

Create a Simple WordPress XML Feed

Drag & drop to create a custom WordPress XML feed.

Create a WordPress XML Feed with Custom Schema

Code a custom XML feed with any complex structure.

How to Export WordPress to CSV, Excel, and XML

To export WordPress data to CSV, Excel, or XML, go to WP All Export › New Export and select the type of data you'd like to export. Next, drag and drop the post data to set up your export file. Then run the export to create your customized WordPress export.

Step 1: Select a WordPress Post Type to Export

First, choose the type of data that you would like to export. WordPress separates data into different post types like posts, pages, WooCommerce products, real estate properties, etc. You can export any custom post type or taxonomy by selecting it here.

Step 2: Customize Your WordPress CSV/XML Export

The fields available to export are listed on the right. Drag and drop individual fields, or click Add All to export everything. Move export fields around to reorder the spreadsheet columns. Click to rename individual elements, combine multiple fields, and more.

Everything is available for export, including media, images, categories and tags, custom fields, etc. Things like WooCommerce, real estate plugins, Yoast, and ACF, have custom data that can be exported.

Drag and drop to set up your custom WordPress CSV/XML export.

Step 3: Confirm and Run Your Export

When you have finished selecting the data to export, click Continue to verify your export settings. Click Confirm & Run Export when you're ready to run your export.

Run your WordPress CSV/XML export.

Step 4: Download Your WordPress CSV/XML Export

After the export finishes, you'll be able to download the generated file. At this point you can choose to migrate this data to another WordPress install, edit it in Excel and import it back to this WordPress install, run this export on a schedule, or send the data to Dropbox, Google Drive, email, and over 1000+ other external apps via Zapier.

Click to download your WordPress CSV/XML export.