Docs – Coding Chicken

Relations

chyland — Mon, 22 Jan 2024 15:54:41 +0000

When importing relations, the relation you want to match must already exist. Otherwise, import it first then run the import that will link the two objects.

If a limit is set on the number of set relations then the oldest relation pair will be replaced with the latest relation pair as they’re imported.

By default, existing relations are first removed and then recreated each time the import runs.

You must use the ‘Set with XPath field to provide the related object ID:

The object ID is required and must be the ID as it’s stored in WordPress (Post ID, User ID, CCT ID, etc). It’s required that you provide these IDs explicitly due to the vast number of different object types which can be configured for use in relations.

With WP All Import’s ability to run custom code, you can often automate some of that ID translation though: https://www.wpallimport.com/documentation/inline-php/

Here’s a brief example showing how you might get the IDs for a custom post type’s records when matching by Title:

Function Editor example:

function my_get_destination($title){
    $destination = wp_all_import_get_page_by_title($title,"destination");

    return $destination->ID ?? '';
}

Called with:

[my_get_destination({YourFieldElement[1]})]

In action:

Gallery Field

chyland — Sat, 23 Dec 2023 01:17:28 +0000

Importing both single and multiple images is supported for the Gallery field.

Download Images Hosted Elsewhere

For a single image you only need to either enter the image link to use for all imported records, or, map the element from your file that contains each record’s image link:

If importing multiple images to each Gallery, each image link must be separated with two exclamation points:

Use Image(s) Currently Uploaded in /path/to/wpallimport/files

For a single image you only need to either enter the image filename to use for all imported records, or, map the element from your file that contains each record’s image filename:

If importing multiple images to each Gallery, each image filename must be separated with two exclamation points:

Using FOREACH Style Image Mapping

If all of the element names are the same for your images elements (such as {img[1]}, {img[2]}, {img[3]}, etc) then you can use the snippet below with your actual element name to import them as required:

[str_replace(“,”,”!!”, {img})]

More advanced mappings are possible for cases where you may have elements that begin with the same name for example. If you have elements named: {image_number_one[1]}, {image_number_two[1]}, {image_number_three[1]}

You could use a snippet like below that only targets the start of each element name to import those:

{./*[starts-with(local-name(), ‘image_number’)]}

These mapping styles will work when downloading images hosted elsewhere or when using images from the /files directory. Just be sure that the required data is returned (links for downloads and filenames for retrieving from /files).

Installation

chyland — Sat, 23 Dec 2023 01:07:14 +0000

Install the free JetEngine Importer:

Download the Pro Pack:

Install the Pro Pack:

Activate the Pro Pack:

Switcher Field

chyland — Sat, 23 Dec 2023 00:58:59 +0000

Importing to the JetEngine Switcher field is accomplished by either selecting an existing option for all imported records. Or by using the ‘Set with XPath’ option to set values based on values in your import file.

When using the ‘Set with XPath’ option you can use the tooltip to view the options configured for the field. An option should already be configured for the field in the JetEngine configuration before you import it.

Checkbox Field

chyland — Sat, 23 Dec 2023 00:57:14 +0000

Importing to the JetEngine Checkbox field is accomplished by either selecting an existing option for all imported records. Or by using the ‘Set with XPath’ option to set values based on values in your import file.

Radio Field

chyland — Sat, 23 Dec 2023 00:55:12 +0000

Importing to the JetEngine Radio field is accomplished by either selecting an existing option for all imported records. Or by using the ‘Set with XPath’ option to set values based on values in your import file.

When using the ‘Set with XPath’ option you can use the tooltip to view the options configured for the field. An option should already be configured for the field before you import it.

Select Field

chyland — Sat, 23 Dec 2023 00:45:40 +0000

Importing to the JetEngine Select field is accomplished by either selecting an existing option for all imported records. Or by using the ‘Set with XPath’ option to set values based on values in your import file.