12.2.4. Action Commands¶

The available action commands are explained below. You can see Filter Commands to learn what commands are and how they are used.

12.2.4.2. Find and replace¶

This command finds something in the subject value and replaces it with something.

Options
Find and replace:
See Find and Replace Setting

12.2.4.3. Make upper case¶

This command makes all the letters of the subject value uppercase. For example, if the subject value is NASA lands Perseverance on Mars, then it will become NASA LANDS PERSEVERANCE ON MARS.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.4. Make lower case¶

This command makes all the letters of the subject value lowercase. For example, if the subject value is NASA lands Perseverance on Mars, then it will become nasa lands perseverance on mars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.5. Make title case¶

This command makes the first letters of the words in the subject value uppercase. For example, if the subject value is NASA lands Perseverance on Mars, then it will become Nasa Lands Perseverance On Mars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.6. Make snake case¶

This command makes the letters of the subject value lowercase, replaces spaces with underscore character, and puts an underscore character between two adjacent uppercase letters. For example, if the subject value is NASA lands Perseverance on Mars, then it will become n_a_s_a_lands_perseverance_on_mars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.7. Make kebab case¶

This command makes the letters of the subject value lowercase, replaces spaces with dash character, and puts a dash character between two adjacent uppercase letters. For example, if the subject value is NASA lands Perseverance on Mars, then it will become n-a-s-a-lands-perseverance-on-mars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.8. Make camel case¶

This command makes the first letter of the subject value lowercase, makes the first letter of the words (other than the first word) uppercase, and removes the spaces. For example, if the subject value is NASA lands Perseverance on Mars, then it will become nASALandsPerseveranceOnMars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.9. Make studly case¶

This command makes the first letters of the words uppercase and removes the spaces. For example, if the subject value is NASA lands Perseverance on Mars, then it will become NASALandsPerseveranceOnMars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.10. Make first letter upper case¶

This command makes the first letter of the subject value uppercase. For example, if the subject value is nasa lands Perseverance on Mars, then it will become Nasa lands Perseverance on Mars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.11. Make slug¶

This command makes the subject value a slug. A slug is a URL-friendly text that does not contain characters not suitable for a URL, that is lowercase, and whose space characters are replaced with dash characters. For example, if the subject value is #NASA lands Perseverance _on_ Mars!!!, then it will become nasa-lands-perseverance-on-mars.

Options
Treat as HTML?: Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.

12.2.4.12. Limit words¶

This command removes the excessive words from the subject value and, optionally, put a text at the end of the subject value if its words are cut.

Options
Maximum word count:
Enter how many words the subject value can contain at maximum
End text:If you want to add a text at the end of the cut subject values, enter that text here. The text will be added to the end of the subject value only if its words are cut.
Treat as HTML?:Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.
Example 1
Subject value: NASA lands Perseverance on Mars 3 ... NASA lands Perseverance...
Example 2
Subject value: NASA lands Perseverance on Mars 3 Empty NASA lands Perseverance
Example 3
Subject value: NASA lands Perseverance on Mars 10 ... NASA lands Perseverance on Mars

12.2.4.13. Limit characters¶

This command removes the excessive characters from the subject value and, optionally, put a text at the end of the subject value if its characters are cut.

Options
Maximum character count:
Enter how many characters the subject value can contain at maximum
End text:If you want to add a text at the end of the cut subject values, enter that text here. The text will be added to the end of the subject value only if its characters are cut.
Treat as HTML?:Check this if the subject’s value is HTML, and you want to work with the texts of the elements. If you do not check this in that case, then the HTML code will be considered as well.
Example 1
Subject value: NASA lands Perseverance on Mars 20 ... NASA lands Persevera...
Example 2
Subject value: NASA lands Perseverance on Mars 20 Empty NASA lands Persevera
Example 3
Subject value: NASA lands Perseverance on Mars 100 ... NASA lands Perseverance on Mars

12.2.4.14. Remove empty HTML elements¶

This command removes empty HTML elements and HTML comments from the subject value. The HTML tags that do not have a content are excluded, such as img tag.

Options
Check this checkbox if you want to remove HTML comments from the subject value.
Excluded tag names:
Enter the HTML tag names that must not be removed even if they do not have content in them. You should separate the tags by commas. The HTML tags that do not have a content are already excluded, such as img tag.
Example 1
Subject value: Remove comments?: NASA lands Perseverance on Mars

checked Empty NASA lands Perseverance on Mars
Example 2
Subject value: Remove comments?: NASA lands Perseverance on Mars

unchecked Empty NASA lands Perseverance on Mars
Example 3
Subject value: Remove comments?: NASA lands Perseverance on Mars

checked p, a NASA lands Perseverance on Mars

12.2.4.16. Template¶

This command allows you to add a text before or after the subject value or replace it with a different value.

Options
Template: Define the new value. You can add [wcc-item] shortcode anywhere in the template to include the original subject value.
Example 1
Subject value: Mars Rover Incredible [wcc-item] Incredible Mars Rover
Example 2
Subject value: Mars Rover [wcc-item], [wcc-item], the incredible [wcc-item] Mars Rover, Mars Rover, the incredible Mars Rover
Example 3
Subject value: Mars Rover Perseverance Perseverance

12.2.4.17. Exchange attributes¶

This command exchanges the values of two attributes of the same element.

Options:
Attribute names:
Enter the names of the attributes whose values will be exchanged with each other. If the value of Attribute 2 does not exist, the values will not be exchanged.
Example 1
Subject value:   src data-src  
Example 2
Subject value:   src data-src  
Example 3
Subject value:   src data-src  

12.2.4.18. Remove¶

This command removes the element provided as the subject value from the HTML. If the element has elements inside, they will be removed as well.

12.2.4.19. Remove attributes¶

This command removes the specified attributes from the subject elements.

Options
Attribute names:
Define the names of the attributes that will be removed from the element. To enter multiple attributes, separate them with commas. For example, attribute1 defines only one attribute, while attribute1, attribute2 defines two attributes. The order of the attributes is not important.
Example 1
Subject value: Attribute names:   data-src  
Example 2
Subject value: Attribute names:   data-size, data-src  

12.2.4.20. Clone¶

This command clones the element provided as the subject value. The cloned element will be placed as the next sibling to the original element and given the ID you specified. Entering an ID is mandatory for this command, because it might be hard to interact with the cloned element if it does not have an ID. This command assumes that you want to interact with the cloned element.

Options
Clone all found elements?:
Check this if all the elements found by the provided CSS selectors must be cloned. If this is not checked, only the first one in the found elements will be cloned.
Element ID:Enter the ID that will be assigned to the cloned element. You can use this ID to interact with the cloned element later. An ID attribute cannot have a space character in it, according to the specifications. However, if you enter a space-separated list, it will be considered as multiple IDs. In case of cloning multiple elements, the given ID(s) will be suffixed a number for each cloned element. For example, if the given ID is my-element my-clone, and there are three cloned elements, while the first clone will have my-element my-clone as its ID, the second and third ones will have my-element2 my-clone2 and my-element3 my-clone3 as their IDs.

12.2.4.21. Create¶

This command is used to create one more HTML elements and insert them into the target page relative to a specific element defined by its CSS selector. If there are multiple target elements, a new HTML element will be created and inserted for each of them.

Options
Location: Short codes: Select the location of the new HTML element relative to the target element, which is the element specified via its CSS selector. For example, “After” means that the new HTML element should be inserted just after the target element, as a sibling. “Inside Top” means that the new HTML element should be inserted inside the target element as the first child. Short codes that can be used in the code of the new HTML element. You can hover over the short codes to see what they do. You can click to the short code buttons to copy the short codes. Then, you can paste the short codes into the new HTML element’s code to include them. They will be replaced with their actual values. Define your HTML element. The code you enter here must be a valid HTML code. If it is not valid, you might get unexpected results. Otherwise, your element will be created and inserted into the specified location.
Example 1
Subject value: Location: 

Title

 After 
My element
 

Title

My element

Example 2
Subject value: Location: 

Title

 Before 
My element
 
My element

Title


Example 3
Subject value: Location: 

Title

 Inside Top 
My element
 
My element

Title


Example 4
Subject value: Location: 

Title

 Inside Bottom 
My element
 

Title

My element


12.2.4.22. Unwrap¶

This command removes an element’s tags, while keeping its content.

Example 1
Subject value: 

Title

 

Title


Example 2
Subject value: 

My Title

 My Title 

12.2.4.23. Calculate¶

This command calculates a value by using the subject value and replaces the subject value with the result of the calculation.

Important

Although this command lets you assign a thousands separator and use , as the decimal separator, the result will not be a valid number when you do these. For the command to be able to result in a number when the subject value is a number, you must use . as the decimal separator, and you must not use a thousands separator.

Options
Decimal separator:
Select the decimal separator to be used in the resultant number. The one that is not selected will be used as the thousands separator.
Use thousands separator?:
Check this if you want to use thousands separator in the result.
Precision:Enter how many digits at max there can be after the decimal separator. Default: 0
Formula:Enter formulas that will be used to create the new value. If you enter more than one, a random one will be used. Use x or X to include the original value. For example, you can write x * 3^2 to multiply the number by 9. You can use the following operators: *, +, /, -, ^

12.2.4.24. Send email notification¶

This command sends an email to the email addresses specified in Email addresses setting. Also, the notifications must be activated via Notifications are active? setting. If the notifications are not active, or there are no email addresses defined, this command does not send an email notification.

Options
Title: Message: Title of the notification. You can use the short codes shown at the top of the command container to include certain information into the template. If you leave this empty, a default template will be used. However, the default template will not include specific information that you can use to differentiate notifications. Hence, it is recommended that you enter a descriptive value. Enter the message that will be sent as a notification. You can use the short codes shown at the top of the command container to include certain information into the template. If you leave this empty, a default template will be used. However, the default template will not include specific information that you can use to differentiate notifications. Hence, it is recommended that you enter a descriptive value. A text that will be used to identify this notification to limit the number of same-type notifications to be sent. Getting numerous notifications about the same thing will probably bother you. To prevent this, just enter a text so that the plugin can reduce the number of notifications. If you leave this empty, the notifications will not be limited. You can use the same identifier for other notification commands as well. For example, you can enter notification-about-low-price. When a notification is sent, the date of the notification will be stored for this identifier. The date will be checked before sending another notification. This defines the minimum duration between two notifications, in minutes. For example, if you enter 30, you will not get more than one notification within 30 minutes. For this to work, you have to define the notification identifier as well. If you leave this empty, the default value will be used, which is 30.
Short codes
[wcc-request-url]:
URL of the page being crawled
[wcc-status-code]:
HTTP status code of the response of the crawl request. E.g. 400, 403, 200, 500, etc.
[wcc-site-name]:
Name of the site, defined by you
[wcc-site-id]:ID of the site
[wcc-site-edit-url]:
The URL that displays the site edit page
[wcc-current-time]:
Current date and time, e.g. 2021-02-24 09:25:52

12.2.4.25. Stop¶

This command stops the execution of the crawling operation immediately. If there is a post that is already saved for the current URL, it will not be deleted. If this is executed during the crawling of a multi-page post, the status of the post will remain as draft.

Options
Reason: A short explanation about why the crawling should be stopped. This will be added to the log message and to the information messages that you will see when this command is run. This is optional. If you define this, you will be able to understand why this command is run when it is run.

12.2.4.26. Stop and delete the post¶

This command stops the execution of the crawling operation immediately. Then, deletes the post created in your site for the current URL (the URL being crawled), if the post exists.

Options
Reason: A short explanation about why the crawling should be stopped and the post should be deleted. This will be added to the log message and to the information messages that you will see when this command is run. This is optional. If you define this, you will be able to understand why this command is run when it is run. Check this if the URL of the post should be deleted from the database. When the URL is deleted, the plugin will be able to save the URL to the database again, if the URL is found in a category page. This means that the post can be saved again. If the URL is not deleted, the post will not be saved again.

12.2.4.27. Set author¶

This command assigns the author of the post.

Options
Author: Select the author that will be assigned to the crawled post.

12.2.4.29. Set post status¶

This command assigns the status of the post, such as Draft or Pending.

Options
Post status: Select the status that will be assigned to the crawled post.

This command adds tags to the crawled post. It can also delete the existing tags.

Options
Tags: Delete other tags?: Define the tags that will be added to the tags of the post. To enter multiple tags, separate them with commas. For example, my tag defines only one tag, while my, tag defines two tags. Check this if you want to delete other existing tags, if any exists.

This command adds the crawled post under the given categories. It can also delete the existing categories.

Important

If you want the defined categories not to be added under the main category selected in Category URLs setting, you must enable Do not add the category defined in the category URLs? setting.

Options
Categories: Delete other categories?: Enter the categories. Add a new item for each top-level category. You can add child categories to the top-level category by separating them with > character. For example, Cities puts the post under that category, while Cities > Metropolitan > Chicago puts it under the last category after creating its parent categories. Check this if you want to delete other existing categories, if any exists. This does not delete the categories from WordPress. This just removes the post from those categories.

12.2.4.32. Field template¶

This command is used to apply a template to multiple fields of the post. For example, if you want to prepend a text to the title, content, and tags, you can use this command to prepend that text to all these fields.

Options
Fields: Select the fields that will be changed by using the template. If there is no field selected, no field value will be changed. Short codes that can be used in the template. You can hover over the short codes to see what they do. You can click to the short code buttons to copy the short codes. Then, you can paste the short codes into the template to include them. They will be replaced with their actual values. Enter your template. What you define here will be used as the new value of the specified fields. The original value will be replaced with this template.
Example 1
Subjects:
Title: My title my-post-slug 
My content
tag1, tag2
Fields:

Title, Content, Tags

Template:

My prefix - [wcc-item]

Result:
Title: My prefix - My title my-post-slug My prefix -
My content
My prefix - tag1, My prefix - tag2