Mods - Blog Posts category archives

Add tax item to an escrow order

This post is an addition to the article How to add taxes and discounts to a payment order and explains how to add tax item to escrow orders. We will use Taxable plugin as the basic tool for registering custom payment items.

Escrow orders introduced in the HireBee theme. They are processing differently to regular orders. So we should add modifications to make possible for Taxable plugin to add items to an escrow order.

You can add it in a custom plugin or child theme functions.php file. Or use Code Snippets plugin (more details in the instruction).

function arthemes_org_create_escrow_order( $workspace_id, $workspace ) { $order = appthemes_get_order_connected_to( $workspace_id ); if ( ! $order || ! class_exists( 'TAXABLE_Registry' ) ) { return; } $plugin = new TAXABLE_Registry(); $plugin->add_taxes( $order ); } add_action( 'waiting_funds_workspace', 'arthemes_org_create_escrow_order', 11, 2 );

When a workspace and new escrow …

Disable receipt emails with 0 total for Vantage and Clipper themes

Receipt emails always send if option "Charge for Items" enabled in Vantage or Clipper themes. Even in cases when order total amount is 0.

There is no setting to disable such empty receipt emails, but it can be done using a small mod.

You can add it in a custom plugin or child theme functions.php file or use Code Snippets plugin (more details in the instruction).

This code filters parameters of the receipt email and removes the receiver if order total is 0. This will work fine in most cases. But be careful using AppThemes Coupons plugin and 100% discounts as it may also generate orders with zero total.

Display a site logo on mobile view for the Vantage and ClassiPress themes

The site logo does not display on mobile view for Vantage and ClassiPress themes. But it's pretty simple to fix via self-made child theme.

If you don't have one, read how to create a Vantage child theme and ClassiPress child theme. Moreover, there is a ready-made ClassiPress child theme included in the classipress/examples/ folder

A child theme allows override parent theme templates in case the template file can be located in the child theme with the same name and related path.

So we need to copy the file nav-mobile-title-bar.php from "parts/" folder of the parent theme to the same folder of your child theme. And then, add some modifications to a new file.

In the child theme, open the new file, parts/nav-mobile-title-bar.php find the line with code:

Add below following line of code:

<?php if ( function_exists( 'the_custom_lo…

Home page banner with video background for Vantage and HireBee themes

Home page banners for Vantage and HireBee themes designed to display an image on the background.

You just need to set the Featured Image for the Home Page.

By default it looks like this:

Default HireBee home page banner

Actually, you can display a video as well, but it's not so obvious and below it will be explained how to.

While ClassiPress theme has a Customizer option to upload a video instead of image, the Vantage and HireBee still require some more actions.

We will use the Gutenberg block editor and only one "Cover" block.

Create reusable block from your existing home page content

Group all existing blocks and add group to reusable blocks. Give it a name, for instance "Welcome banner". And remove it from the page.

Add new Cover block

Create new a "Cover" block and upload your video file in it.

Add your …

Replace the Price with Sold tag for sold ClassiPress Ads

Currently, ClassiPress theme displays a "Sold" warning on the single ad page. But it's not reflected on the ad in loops and doesn't show any warning or sold tag.

Following code snippet replaces the Price with Sold tag for ads marked sold.

ClassiPress Sold Tag example

You can add it in a custom plugin or child theme functions.php file or use Code Snippets plugin (more details in the instruction).

/** * Adds the ad price field in the loop before the ad title. * * For sold ads replaces price with SOLD tag. * * @return void */ function arthemes_ad_loop_price() { global $post; if ( APP_POST_TYPE !== $post->post_type ) { return; } // Display Price tag for non-sold ads. if ( 'yes' !== $post->cp_ad_sold ) { cp_ad_loop_price(); return; } ?> <div class="price-wrap sold-wrap"> <span class="tag-head"><span class="post-price"><?php esc_html_e( 'Sold', APP_TD ); ?></span></span> </div> <?php } add_action( 'ini…

Disable Favorite Listings in Vantage theme

Favorite listings is the build-in feature in Vantage theme. But for some sites it is not needed.

Following PHP code snippet will disable Favorite Listings. You can add in a custom plugin or child theme functions.php file. Alternatively, Code Snippets plugin can be used (more details in the instruction).

add_filter( 'va_fave_listing_link', '__return_empty_string' ); add_filter( 'va_header_menu_primary_items_user', function( $fields ) { unset( $fields['favorites'] ); return $fields; } );

Customize AppThemes Importer

The AppThemes themes provided with a built-in listing importer, which allows importing new listings using CSV spreadsheets.

Currently, following themes support the AppThemes Importer feature: ClassiPress, Vantage, Clipper and JobRoller.

Listings can be imported with title, description, excerpt, status, author, date, slug, attachments, Geo data (if theme supports), custom fields, taxonomy terms and even taxonomy meta.

Each theme configures the Importer with a list of fields it should process. Site owners can check out this list by downloading sample CSV file and add their listings for import by adding data in appropriate spreadsheet columns.

The only issue is that site owners can't just add few more columns in a listings table and expect that the Importer will add this data to new listings.

The Importer doesn't understand where to add this new data, such as custom fields, taxonomy terms or post core fields.

Hooks Inven…

Toggle fields group on the ClassiPress listing form

This mod can be useful if your ClassiPress listing form has too many fields and you want to toggle fields group visibility via button or a link.

Toggle visibility for a fields group

Especially, this important for mobile devices, where the long forms look complex and boring for your ad authors.

There are only two steps to implement this mod on your ClassiPress site.

1. Select which fields you want to toggle.

Use ClassiPress form builder and move all these fields below the listing Description field. The Description field will be the last field to be shown on page load. All fields below will be hidden until user clicked the Toggle link.

2. Add JavaScript snippet on your page.

Add the following code in your theme JavaScript scripts file.

jQuery( function( $ ) { $( 'form.form_step #list_post_content' ).each( function() { var collapsed = $( this ).nextUntil( '.ad-details-images-sep', '.form-field' ); if ( collapsed.le…

Customize Category Menu for the Vantage theme

The Vantage theme allows displaying category mega menu in the navigation bar and on the dedicated Categories page.

Vantage Category Menu

Currently, there are no options for customization Category menu, but fortunately it has all necessary hooks and filter for that.

The filter "va_listing_categories_{$location}_args" allows changing parameters and alternate category menu for navigation and categories page separately. Dynamic part {$location} determines the location of the menu to apply changes for:

va_listing_categories_dir_args - applies changes to menu on the Categories page.va_listing_categories_menu_args - applies changes to the navigation mega menu. Filter 'va_listing_categories_{$location}_args' Basic parameters 'menu_cols' - (int) Columns number. Default 2 for page or 3 for navigation menu.'menu_depth' - (int) Number of sub categories levels. Default 3.'menu_sub_num' - (int) Max number of subcategories. Default 3.'…

Custom code and styles for CP Addons plugin for ClassiPress

The main idea behind the CP Addons plugin is to highlight some ClassiPress ads over others. Ad owners gladly pay for it and your site makes a profit. Below you will find few insights on how to style featured ads with samples.

Featured Ad Ribbons

A Ribbon is the most popular way to highlight featured ads. Usually, this is colored band with the text adjacent to a featured image or ad block in general.

Different ClassiPress versions and child themes have different styles, what requires different ways to add ribbons. Here we provide some samples for most frequent cases.

Featured Ads ribbon for ClassiPost v1.3.8

ClassiPost is one of the most popular ClassiPress v3 child themes, whose users done a lot of requests for custom CP Addons styles.

How it looks Featured Ads ribbon on the ClassiPost ad Code

Add the CSS code to the Additional CSS section of your theme Customizer:

.featured-ad_listing-vip .image-item { overf…