WooCommerce Translation Integration

Overview

ShahiTranslate Pro seamlessly integrates with WooCommerce to provide complete e-commerce translation. Product titles, descriptions, categories, attributes, checkout pages, cart messages, and customer emails are all translated automatically.

What Gets Translated

Product Content

Product Titles:

1. Main product name in shop listing
2. Single product page title
3. Related products display
4. Cross-sells and up-sells

Product Descriptions:

5. Long description (main content)
6. Short description (excerpt)
7. Tab content (Description, Additional Info)

Product Categories & Tags:

8. Category names
9. Category descriptions
10. Category slugs (optional)
11. Product tags

Product Attributes:

12. Color names (e.g., “Red” → “Rojo”)
13. Size labels (e.g., “Large” → “Grande”)
14. Custom attributes
15. Attribute values

Product Meta:

16. SKU (usually not translated)
17. Price (format adjusted per locale)
18. Stock status messages
19. Shipping class names

Shop Pages


Shop Catalog:
`
Store > Products > All Translated
`

20. Shop page title
21. Product listing descriptions
22. Category filter labels
23. Sort dropdown options
24. “Add to cart” buttons
25. Price labels

Single Product Page:

26. Product name
27. Full description
28. Short description
29. Reviews section
30. “Add to basket” button
31. Quantity label
32. Stock availability
33. Shipping info
34. Product tabs

Product Archives:

35. Category archive pages
36. Tag archive pages
37. Search results
38. Filtered views

Cart & Checkout


Shopping Cart:

39. “Cart” heading
40. Product names in cart
41. Column headers (Product, Price, Quantity, Total)
42. “Update cart” button
43. “Proceed to checkout” button
44. Coupon field label
45. Empty cart message
46. Cart totals section

Checkout Page:

47. Billing fields labels
48. Shipping fields labels
49. Order notes placeholder
50. Payment method labels
51. Payment descriptions
52. “Place order” button
53. Terms & conditions text
54. Privacy policy link

Order Confirmation:

55. “Thank you” message
56. Order details table
57. Order summary
58. Payment info
59. Shipping info

Customer Emails


Email Templates:

60. Order confirmation
61. Order processing
62. Order completed
63. Order cancelled
64. Password reset
65. New account welcome
66. Invoice/receipt emails

Email Content Translated:

67. Subject lines
68. Greeting text
69. Body content
70. Footer text
71. Button labels
72. Table headers

WooCommerce Widgets


Supported Widgets:

73. Product Categories
74. Product Tags
75. Recent Products
76. Top Rated Products
77. On-Sale Products
78. Shopping Cart widget
79. Price Filter
80. Attribute Filter

Enabling WooCommerce Translation


Basic Setup


Location: ShahiTranslate Pro → Settings → General

`
Settings → General → WooCommerce Support

✅ Translate WooCommerce products, categories, and shop pages

Save Changes
`

That’s It! Translation starts immediately.

Verification


Check Translation Working:

81. Enable at least one language:

`
Settings → Languages
Select: Spanish, French, etc.
Save
`

82. Visit shop in another language:

`
yoursite.com/es/shop/
or
yoursite.com/shop/?lang=es
`

83. Verify products are translated:

– Product titles show in Spanish
– Descriptions in Spanish
– “Add to cart” button in Spanish

First-Time Configuration


Recommended Settings:

`
ShahiTranslate Pro → Settings

✅ General Tab:
✅ Enable WooCommerce translation
✅ Show native language names
✅ Auto-detect browser language

✅ SEO Tab:
URL Structure: Sub-directory (/es/)
✅ Add hreflang tags

✅ Advanced Tab:
✅ Enable translation cache
Cache duration: 86400 seconds
`

Product Translation


Automatic Translation


When Enabled:
Products translate automatically when visitors switch language.

Example:

English:
`
Product: “Leather Wallet”
Description: “Genuine leather wallet with RFID protection”
Price: $45.00
Stock: “In stock”
`

Spanish (auto-translated):
`
Product: “Billetera de Cuero”
Description: “Billetera de cuero genuino con protección RFID”
Price: 45,00 $
Stock: “En stock”
`

Manual Product Translation


Override Automatic Translations:

Some merchants want custom translations for marketing reasons.

Using Translation Editor:

Location: Edit Product → ShahiTranslate Pro Meta Box

`
Edit Product: “Leather Wallet”

Original Language: English
✅ Mark as original language content

Translations:
┌──────────────────────────────────────┐
│ Spanish (es) [Edit]│
│ Title: Billetera de Cuero Premium │
│ [Save Spanish Translation] │
│ │
│ French (fr) [Edit]│
│ Title: Portefeuille en Cuir │
│ [Save French Translation] │
└──────────────────────────────────────┘
`

Manual Override Example:

Automatic: “Billetera de Cuero” (literal)
Manual: “Billetera de Cuero Premium” (better marketing)

Why Manual?:

84. Better keyword targeting
85. Marketing language
86. Cultural adaptation
87. Brand consistency
88. Legal compliance

Bulk Product Translation


For Large Catalogs:

Method 1: WP-CLI (fastest):
`powershell
wp stp translate-products –lang=es –force
`

Method 2: Admin Bulk Actions:
`
Products → All Products
☑ Select products
Bulk Actions → Translate to Spanish → Apply
`

Method 3: Import/Export:

89. Export products to CSV
90. Add translated columns
91. Import with WooCommerce importer

Category & Taxonomy Translation


Product Categories


Automatic Translation:
Category names translate on frontend automatically.

Example:
`
Category: “Men’s Clothing”
Spanish: “Ropa de Hombre”
French: “Vêtements pour Hommes”
German: “Herrenkleidung”
`

Category Slugs:

Default (English slug for all):
`
/category/mens-clothing/
/es/category/mens-clothing/ (English slug)
`

With URL Translation Enabled:
`
/category/mens-clothing/
/es/category/ropa-de-hombre/ (Spanish slug)
`

Configuration:
`
Settings → SEO & URLs
✅ Enable URL Translation
`

Product Tags


Translation:
Tags translate automatically.

Example:
`
Tag: “Sale”
Spanish: “Oferta”
French: “Solde”
`

Tag Cloud:
Tag cloud widget shows translated tags.

Product Attributes


Global Attributes:

Setup:
`
Products → Attributes
Add Attribute: “Color”
Terms: Red, Blue, Green
`

Translation:
Terms translate automatically:
`
English: Red, Blue, Green
Spanish: Rojo, Azul, Verde
French: Rouge, Bleu, Vert
`

Custom Product Attributes:
Also translate automatically.

Cart & Checkout Translation


Cart Page


Translated Elements:

English Cart:
`
┌────────────────────────────────────────┐
│ Shopping Cart │
├─────────────┬──────┬─────────┬─────────┤
│ Product │ Price│ Quantity│ Total │
├─────────────┼──────┼─────────┼─────────┤
│ Leather │ $45 │ 1 │ $45 │
│ Wallet │ │ [Update]│ │
└─────────────┴──────┴─────────┴─────────┘
Subtotal: $45.00
[Continue Shopping] [Proceed to Checkout]
`

Spanish Cart:
`
┌────────────────────────────────────────┐
│ Carrito de Compras │
├─────────────┬──────┬─────────┬─────────┤
│ Producto │Precio│ Cantidad│ Total │
├─────────────┼──────┼─────────┼─────────┤
│ Billetera de│ 45 $ │ 1 │ 45 $ │
│ Cuero │ │[Actual.]│ │
└─────────────┴──────┴─────────┴─────────┘
Subtotal: 45,00 $
[Seguir Comprando] [Finalizar Compra]
`

Coupon Section:
`
English: “Have a coupon? Click here to enter your code”
Spanish: “¿Tienes un cupón? Haz clic aquí para ingresar tu código”
`

Checkout Page


Billing Fields:

English:
`
First Name: _
Last Name: _
Company Name (optional): _
Country: [Select country ▼]
Street address: _
City: _
State: [Select state ▼]
ZIP Code: _
Phone: _
Email: _
`

French:
`
Prénom: _
Nom: _
Nom de l’entreprise (optionnel): _
Pays: [Sélectionner un pays ▼]
Adresse: _
Ville: _
État: [Sélectionner un état ▼]
Code postal: _
Téléphone: _
Email: _
`

Payment Methods:
`
English:
○ Direct Bank Transfer
○ Check Payments
○ Cash on Delivery
● PayPal

Spanish:
○ Transferencia Bancaria Directa
○ Pagos con Cheque
○ Pago Contra Entrega
● PayPal
`

Order Button:
`
English: [Place Order]
German: [Bestellung Aufgeben]
Italian: [Effettua l’Ordine]
`

Order Confirmation


Thank You Page:

English:
`
Thank you. Your order has been received.

Order Number: #12345
Date: January 15, 2024
Total: $45.00
Payment method: PayPal
`

Spanish:
`
Gracias. Tu pedido ha sido recibido.

Número de Pedido: #12345
Fecha: 15 de enero de 2024
Total: 45,00 $
Método de pago: PayPal
`

Email Translation


Customer Emails


Email Types Translated:

92. New order (admin notification)
93. Processing order (customer)
94. Completed order (customer)
95. Refunded order (customer)
96. Customer invoice
97. Customer note
98. Reset password
99. New account

Email Language Detection


How It Works:

Plugin detects customer’s language from:

100. Order language (stored in order meta)
101. User profile language preference
102. Browser language (fallback)

Example:

Customer orders in Spanish → Email sent in Spanish

Email Content Translation


Subject Lines:
`
English: “Your order has been received – Order #12345”
Spanish: “Tu pedido ha sido recibido – Pedido #12345”
French: “Votre commande a été reçue – Commande #12345”
`

Body Content:

English Email:
`
Hi John,

Thank you for your order. Your order details are below:

Order #12345

Product Qty Price
Leather Wallet 1 $45.00

Subtotal: $45.00
Shipping: $5.00
Total: $50.00

Best regards,
Your Store Team
`

Spanish Email:
`
Hola John,

Gracias por tu pedido. Los detalles de tu pedido están a continuación:

Pedido #12345

Producto Cant. Precio
Billetera de Cuero 1 45,00 $

Subtotal: 45,00 $
Envío: 5,00 $
Total: 50,00 $

Saludos cordiales,
Equipo de Tu Tienda
`

Email Template Customization


Location: WooCommerce → Settings → Emails

Each email can be customized per language:

English Template:
`php
// woocommerce/emails/customer-processing-order.php
Dear {customer_name},
Your order is being processed.
`

Create Language-Specific Template:
`
/wp-content/themes/your-theme/woocommerce/emails/
└── es/
└── customer-processing-order.php (Spanish version)
└── fr/
└── customer-processing-order.php (French version)
`

Spanish Template:
`php
// woocommerce/emails/es/customer-processing-order.php
Estimado/a {customer_name},
Tu pedido está siendo procesado.
`

Price Formatting


Currency by Language


Different Currency Per Language:

`php
// Example: Auto-switch currency based on language
function stpwccurrencybylanguage( $currency ) {
$lang = stpgetcurrent_language();

switch ( $lang ) {
case ‘es’:
return ‘EUR’; // Euro for Spanish
case ‘en’:
return ‘USD’; // USD for English
case ‘ja’:
return ‘JPY’; // Yen for Japanese
default:
return $currency;
}
}
addfilter( ‘woocommercecurrency’, ‘stpwccurrencybylanguage’ );
`

Number Formatting


English (US):
`
Price: $1,234.56
`

German:
`
Price: 1.234,56 €
`

French:
`
Price: 1 234,56 €
`

Automatic Localization:
Plugin uses WordPress locale settings to format numbers correctly.

Currency Symbol Position


Configuration:

`
WooCommerce → Settings → General
Currency Options:

103. Currency: EUR
104. Currency Position: Right with space (1234.56 €)

`

Per-Language Override:
`php
function stpwccurrency_position( $position ) {
$lang = stpgetcurrent_language();

if ( $lang === ‘es’ || $lang === ‘fr’ ) {
return ‘right_space’; // 45,00 €
}
return ‘left’; // $45.00
}
addfilter( ‘woocommercecurrencypos’, ‘stpwccurrencyposition’ );
`

Advanced Integration


Variable Products


Variation Attributes:
All variation attributes translate automatically.

Example:

English Variations:
`
Size: Small, Medium, Large
Color: Red, Blue, Green
`

Spanish Variations:
`
Tamaño: Pequeño, Mediano, Grande
Color: Rojo, Azul, Verde
`

Variation Dropdown:
`html

SmallMediumLarge


PequeñoMedianoGrande
`

Grouped Products


Parent Product:
Translates normally.

Child Products:
Each child product title translates.

Example:

English:
`
Wallet Bundle

105. Leather Wallet
106. Card Holder
107. Money Clip

`

Italian:
`
Pacchetto Portafoglio

108. Portafoglio in Pelle
109. Porta Carte
110. Fermasoldi

`

Product Bundles (Extensions)


WooCommerce Product Bundles extension supported:

Bundle items translate including:

111. Bundle title
112. Bundled products
113. Bundle description
114. Discount labels

Subscriptions


WooCommerce Subscriptions extension supported:

Translates:

115. Subscription product titles
116. Subscription descriptions
117. Billing period labels (“Every month” → “Cada mes”)
118. Renewal emails
119. Subscription status messages

Widgets & Shortcodes


WooCommerce Widgets


Product Categories Widget:
`
[Widget]
Product Categories

120. Electronics (12)

– Laptops (5)
– Phones (7)

121. Clothing (23)

`

Spanish:
`
[Widget]
Categorías de Productos

122. Electrónica (12)

– Portátiles (5)
– Teléfonos (7)

123. Ropa (23)

`

Supported Widgets:

124. Products by Category
125. Products by Tag
126. Recent Products
127. Featured Products
128. On Sale Products
129. Top Rated Products
130. Shopping Cart
131. Layered Nav (Filters)

WooCommerce Shortcodes


Shortcodes Work Seamlessly:

`
[products limit=”4″ columns=”4″ category=”electronics”]
`

Products display in current language automatically.

Shortcode Examples:
`
[recent_products limit=”5″]
[featured_products limit=”4″]
[sale_products limit=”3″]
[bestsellingproducts limit=”5″]
[product_category category=”clothing”]
`

All translate automatically.

SEO for Multilingual Shop


Product URLs


Sub-directory Structure (recommended):
`
English: /product/leather-wallet/
Spanish: /es/producto/billetera-de-cuero/
French: /fr/produit/portefeuille-en-cuir/
`

Configuration:
`
Settings → SEO & URLs
URL Structure: Sub-directory
✅ Enable URL Translation
`

Category URLs


English:
`
/product-category/mens-clothing/
`

Translated (with URL translation):
`
/es/categoria-producto/ropa-de-hombre/
/fr/categorie-produit/vetements-pour-hommes/
`

hreflang Tags


Automatic Implementation:

Plugin adds hreflang tags to all WooCommerce pages:

`html `

Pages Covered:

132. Product pages
133. Category archives
134. Shop page
135. Cart
136. Checkout
137. My Account

XML Sitemaps


WooCommerce Pages in Sitemap:

Plugin includes WooCommerce pages in multilingual XML sitemaps:

`xml

https://example.com/product/leather-wallet/



`

Submission:
Submit sitemap to Google Search Console for all languages.

Common WooCommerce Issues


Issue: Products Not Translating


Symptom: Products still show in English when language switched

Causes:

138. WooCommerce support not enabled
139. No languages enabled
140. Cache not cleared

Solutions:
`

141. Enable WooCommerce support:

Settings → General → ✅ WooCommerce Support

142. Enable languages:

Settings → Languages → Select at least one

143. Clear cache:

Settings → Translation Engine → Clear All Cache

144. Test with ?lang=es parameter:

yoursite.com/shop/?lang=es
`

Issue: Cart Not Translating


Symptom: Cart labels in English despite language switch

Causes:

145. WooCommerce templates cached
146. Theme overrides WooCommerce templates

Solutions:
`

147. Clear WooCommerce transients:

WooCommerce → Status → Tools → Clear transients

148. Clear page cache (if using caching plugin)
149. Check theme templates:

/wp-content/themes/your-theme/woocommerce/
Remove custom templates or update them
`

Issue: Checkout Fields Not Translating


Symptom: “First Name”, “Last Name” still in English

Causes:

150. Custom checkout fields plugin
151. Theme adds custom fields
152. Checkout field editor

Solutions:
`

153. Ensure standard WooCommerce fields used
154. For custom fields, add translation:

function stptranslatecustom_field( $fields ) {
$fields[‘customfield’][‘label’] = _( ‘Custom Field’, ‘textdomain’ );
return $fields;
}
addfilter( ‘woocommercecheckoutfields’, ‘stptranslatecustomfield’ );

155. Disable checkout customizer plugins temporarily to test

`

Issue: Emails in Wrong Language


Symptom: Customer receives English email despite ordering in Spanish

Causes:

156. Order language not detected
157. Email template cached
158. SMTP plugin conflict

Solutions:
`

159. Check order meta has language stored:

Orders → View Order → Custom Fields
Look for: stporder_language = es

160. Disable WP Mail SMTP temporarily to test
161. Check email template location:

/wp-content/themes/your-theme/woocommerce/emails/

162. Force email language:

function stpforceemail_language( $locale, $order ) {
return getpostmeta( $order->getid(), ‘stporderlanguage’, true );
}
addfilter( ‘woocommerceemaillocale’, ‘stpforceemaillanguage’, 10, 2 );
`

Issue: Price Format Wrong


Symptom: Price shows $1,234.56 in all languages

Causes:

163. Currency not set per language
164. Number format not localized

Solutions:
`

165. Set locale correctly:

Settings → General → Site Language (affects formatting)

166. Use currency switcher if needed:

Install WooCommerce Multi-Currency
Configure per language

167. Check WooCommerce currency settings:

WooCommerce → Settings → General → Currency Options
`

Best Practices


1. Test Before Going Live


Testing Checklist:

168. ✅ Products translate correctly
169. ✅ Cart works in all languages
170. ✅ Checkout completes successfully
171. ✅ Payment gateways work
172. ✅ Emails sent in correct language
173. ✅ Confirmation page translates
174. ✅ My Account area translates

2. Use Manual Translation for Key Products


When to Override:

175. Featured products
176. Best-sellers
177. Products with specific keywords
178. Marketing campaigns
179. Legal requirements

Why:

180. Better keyword targeting
181. Cultural relevance
182. Brand voice consistency

3. Optimize URLs for SEO


Recommendation:
`
✅ Use sub-directory structure (/es/)
✅ Enable URL translation for slugs
✅ Add hreflang tags
✅ Submit sitemaps to Search Console
`

4. Cache Configuration


Optimal Settings:
`
✅ Enable translation cache
Cache duration: 86400 seconds (24 hours)
✅ Auto-invalidate on product update
`

Why:

183. Fast page loads
184. Reduced API calls
185. Better user experience

5. Monitor Translation Quality


Regular Checks:

186. Review product translations monthly
187. Check customer feedback
188. Monitor cart abandonment rate per language
189. Test checkout flow in all languages

Performance Optimization


Caching Strategy


Product Translation Cache:
`
First visit (Spanish):

190. Check cache for Spanish translation
191. If not found, translate via API
192. Store in cache
193. Display to user

Subsequent visits:

194. Load from cache (instant)
195. No API call needed

`

Cache Hit Rate:
Typically 95%+ for product pages

Database Optimization


Post Meta Storage:
Translations stored as post meta for fast retrieval:

`
wp_postmeta table:
postid | metakey | meta_value
——–|—————————-|——————
123 | stptranslationestitle | Billetera de Cuero
123 | stptranslationesdesc | Descripción…
123 | stptranslationfrtitle | Portefeuille
`

Fast Queries:
WordPress loads post meta efficiently with posts.

Lazy Translation


On-Demand Translation:

Only translate when:

196. Product viewed in specific language
197. Not already cached

Benefits:

198. Saves API quota
199. Faster initial setup
200. Translations improve over time

Multi-Currency Support


Using with Currency Plugins


Compatible Plugins:

201. WooCommerce Multi-Currency
202. WOOCS (Currency Switcher)
203. Currency Switcher for WooCommerce
204. Aelia Currency Switcher

Integration:
`
ShahiTranslate Pro detects currency from:

205. Currency plugin selection
206. Language preference
207. Geolocation

Displays prices in:

208. Correct currency
209. Correct format
210. Correct symbol position

`

Example:
`
English (US): $45.00 USD
Spanish (ES): 42,00 € EUR
Japanese: ¥5,000 JPY
`

Next Steps


211. SEO Settings
212. Translation Cache
213. Manual Translation Editor
214. Advanced Hooks & Filters