=== EfeOEM ===
Contributors: efemed, freemius
Tags: oem, spare parts, product search, cross reference, catalog
Requires at least: 5.8
Tested up to: 7.0.3
Requires PHP: 7.4
Stable tag: 1.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Search spare parts by OEM code, stock code, cross references, and superseded part numbers.

== Description ==

EfeOEM is a lightweight OEM and spare parts search plugin for WordPress.

It helps automotive, industrial, machinery, and spare parts businesses create a searchable product catalog where customers can find products using OEM codes, internal stock codes, competitor cross-reference codes, or superseded part numbers.

Instead of relying only on product titles, EfeOEM extends product search with structured part-number data.

= Find Products by Part Number =

Customers can search using:

* OEM codes
* Internal stock or product codes
* Cross-reference codes
* Competitor reference numbers
* Superseded or previous part numbers
* Product names

This makes EfeOEM especially useful for businesses where customers already know the part number they are looking for.

= Built for Spare Parts Catalogs =

EfeOEM includes its own product structure and does not require ACF or another custom-fields plugin.

Each product can contain:

* Product title and description
* Featured image
* Internal stock code
* Multiple OEM codes
* Multiple cross-reference codes
* Multiple superseded codes
* Brand and compatibility information
* Compatibility notes

= AJAX Search =

Use the `[efeoem_search]` shortcode to add a fast AJAX-powered search box anywhere on your website.

Search results can be filtered by brand and are displayed without requiring a full page reload.

The shortcode can be used in:

* Gutenberg
* Classic Editor
* Elementor
* Other page builders that support WordPress shortcodes
* Theme templates

= Brand & Compatibility Structure =

EfeOEM includes a hierarchical compatibility taxonomy.

This can be used for structures such as:

* Manufacturer → Model
* Brand → Product Family
* Vehicle Brand → Vehicle Model
* Machine Manufacturer → Equipment Model

The structure is intentionally flexible so the plugin can be used outside the automotive industry as well.

= CSV Import =

EfeOEM includes CSV import functionality for adding or updating larger product catalogs.

This is useful for spare-parts companies that already maintain product and OEM data in spreadsheets or exported catalog files.

= WordPress Search Integration =

OEM and stock-code matching can optionally be included in the standard WordPress search system.

This allows existing site search forms to find products using part numbers as well as normal WordPress content.

= SEO Friendly =

EfeOEM uses public WordPress content types and supports search-engine-friendly product URLs.

Rank Math integration is also included when Rank Math is active.

= Theme Override Support =

Developers can customize search-result templates without modifying the plugin.

Copy:

`templates/result-card.php`

to:

`your-theme/efeoem/result-card.php`

and customize it from your theme.

= Who Is EfeOEM For? =

EfeOEM is suitable for:

* Automotive spare parts sellers
* Truck and commercial vehicle parts companies
* Industrial spare parts suppliers
* Machinery and equipment manufacturers
* Agricultural equipment suppliers
* Aftermarket parts companies
* Technical product catalogs
* B2B spare parts websites

= Why EfeOEM? =

Traditional WordPress search is primarily designed around titles and content.

Spare-parts customers often search differently.

They already have a code.

EfeOEM gives those codes a dedicated structure and makes them searchable.

== Installation ==

1. Upload the EfeOEM plugin through the WordPress Plugins screen or install it from the WordPress Plugin Directory.
2. Activate the plugin.
3. Open **EfeOEM Products** in the WordPress admin panel.
4. Add your products and enter their stock, OEM, cross-reference, and superseded codes.
5. Add brands and compatibility information if required.
6. Create or edit a page.
7. Add the following shortcode:

`[efeoem_search]`

8. Publish the page.

The EfeOEM search box is now ready to use.

== Frequently Asked Questions ==

= What is an OEM code? =

An OEM code is a part number assigned by an original equipment manufacturer. Customers often use these codes when searching for compatible spare parts.

= Can one product have multiple OEM codes? =

Yes. You can add multiple OEM codes to the same product.

= Can I add competitor or equivalent part numbers? =

Yes. EfeOEM includes dedicated cross-reference fields for equivalent, competitor, and alternative part numbers.

= Can I add old part numbers? =

Yes. Superseded or previous part numbers can be stored so customers can still find the current product using an older reference number.

= Does EfeOEM require WooCommerce? =

No. EfeOEM works as a standalone WordPress spare-parts catalog.

= Does EfeOEM require ACF? =

No. EfeOEM uses its own product fields and does not require Advanced Custom Fields.

= Can I use EfeOEM with Elementor? =

Yes. Add the `[efeoem_search]` shortcode using Elementor's Shortcode widget.

= Can I filter search results by brand? =

Yes. The search interface supports brand filtering.

= Can I customize the search-result template? =

Yes. Copy the plugin's `result-card.php` template into an `efeoem` folder inside your active theme.

= Does EfeOEM support CSV import? =

Yes. EfeOEM includes CSV import functionality for product and part-number data.

= Is the plugin limited to automotive parts? =

No. The compatibility structure is intentionally generic. It can also be used for industrial machinery, agricultural equipment, technical components, and other spare-parts catalogs.

== Screenshots ==

1. EfeOEM OEM and spare-parts search experience.
2. Product finder interface with OEM, stock-code and compatibility details.
3. Overview of EfeOEM's main search and catalog features.
4. Structured product data with stock, OEM, cross-reference and compatibility information.
5. Add the EfeOEM search box to pages with the `[efeoem_search]` shortcode.

== Changelog ==

= 1.2.4 =
* Improved SQL preparation for OEM code search.
* Improved WordPress.org compatibility and code quality.

= 1.2.3 =
* Improved plugin metadata and contributor information.
* General maintenance improvements.

= 1.2.2 =
* Improved CSV upload handling.
* Improved PHP 8.4 compatibility.
* Improved Elementor and page-builder asset loading.
* Improved search security and SQL handling.
* Added clearer external-service documentation.

= 1.1.8 =
* Initial WordPress.org submission version.

== External Services ==

EfeOEM uses the Freemius SDK for optional licensing, usage analytics, and product communication features.

Freemius may collect limited technical and usage information only when the user explicitly opts in through the Freemius consent screen.

For more information, please review Freemius' privacy policy and terms of service.

EfeOEM does not require Freemius opt-in in order to use the plugin's core functionality.
