Best Practices

This guide covers recommended practices for using Wash: Blog Manager effectively, maintaining SEO, and ensuring a smooth workflow between WordPress and Shopify.

WordPress Configuration

Hide Your WordPress Blog from the Public

When using WordPress solely for content creation (not as your public blog), hide it from the internet:

Option 1: Password Protection

Add to your WordPress .htaccess:

# Password protect entire site
AuthType Basic
AuthName "Restricted Access"
AuthUserFile /path/to/.htpasswd
Require valid-user

# Allow Wash: Blog Manager API access
<Files "wp-json">
  Satisfy any
  Allow from all
</Files>

Option 2: IP Restriction

# Allow only specific IPs
<RequireAll>
  Require ip 192.168.1.0/24
  Require ip 10.0.0.0/8
</RequireAll>

# Allow Wash: Blog Manager webhook IPs
Require ip [Wash: Blog Manager-IP-Range]

Option 3: Subdomain Setup

Use a hidden subdomain:

Public store:  www.yourstore.com (Shopify)
Hidden blog:   cms.yourstore.com (WordPress)

Block Search Engine Indexing

Update your WordPress robots.txt:

# Block all search engines from indexing
User-agent: *
Disallow: /

# Allow Wash: Blog Manager crawler (if needed)
User-agent: Wash: Blog ManagerBot
Allow: /

Or use WordPress settings:

1. Go to Settings > Reading
2. Check Discourage search engines from indexing this site

Recommended WordPress Plugins

Purpose	Recommended Plugin
SEO	Yoast SEO or RankMath
Image optimization	ShortPixel or Imagify
Revision control	WP Revisions Control
Performance	WP Super Cache
Security	Wordfence

Content Organization

Plan Your Blog Structure

Before syncing, plan how WordPress categories map to Shopify blogs:

Strategy A: Mirror Structure
WordPress Categories    →    Shopify Blogs
├── News               →    News
├── Tutorials          →    Tutorials
└── Reviews            →    Reviews

Strategy B: Consolidation
WordPress Categories    →    Shopify Blogs
├── Company News       ─┐
├── Press Releases      ├─→  News
└── Events             ─┘
├── Beginner Guides    ─┐
└── Advanced Guides     ├─→  Guides
                       ─┘

Consistent Formatting

Establish content standards:

• Headings: Use H2 for main sections, H3 for subsections
• Images: Include alt text, consistent sizing
• Links: Use descriptive anchor text
• Featured images: Consistent aspect ratio (16:9 recommended)

SEO Optimization in WordPress

Optimize before syncing:

1. Write meta descriptions - Use SEO plugin
2. Optimize titles - Include keywords
3. Add alt text - All images
4. Use internal links - Link to related content
5. Check readability - Use SEO plugin analysis

Sync Best Practices

Start with Test Content

1. Create 2-3 test posts in WordPress
2. Configure mappings
3. Sync test posts
4. Verify on Shopify
5. Check formatting, images, metadata
6. Adjust settings if needed
7. Proceed with full sync

Use Sync Delay

Enable a short delay before syncing:

Sync delay: 10 seconds

Benefits:

• Catch accidental publishes
• Complete your edits
• Review before sync

Schedule Syncs Wisely

For bulk operations:

• Off-peak hours: Run large syncs during low traffic
• Weekday mornings: Avoid weekend traffic spikes
• Monitor progress: Watch sync logs

Review Before Publishing

Workflow recommendation:

1. Draft in WordPress
2. Internal review (draft status)
3. Publish in WordPress
4. Automatic sync to Shopify
5. Verify on Shopify storefront
6. Share/promote

Smart Redirections Setup

Enable Before Migration

Set up redirections BEFORE you start syncing:

1. Enable Smart Redirections
2. Configure redirect type (301)
3. Test with one post
4. Verify redirect works
5. Proceed with migration

Maintain Redirects Long-Term

Keep redirects active for at least 1-2 years:

• Search engines need time to update
• Backlinks from other sites
• Bookmarks from users
• Printed materials with old URLs

Monitor for 404s

Regularly check for broken URLs:

1. Wash: Blog Manager: Check 404 log in dashboard
2. Google Search Console: Monitor Coverage report
3. Analytics: Track 404 page visits

Author Management

Standardize Author Profiles

Before enabling author mapping:

1. Complete all author bios
2. Add profile pictures
3. Include social links
4. Use consistent formatting

Author Display

Design your Shopify theme to display authors:

{% if article.metafields.wash.author_name %}
  <div class="article-author">
    {% comment %} Author info {% endcomment %}
  </div>
{% endif %}

Image Optimization

Before Upload to WordPress

1. Resize: Max 2048px width
2. Compress: Use tools like TinyPNG
3. Format: JPEG for photos, PNG for graphics
4. Name: Use descriptive filenames

During Sync

Configure optimal settings:

Max width: 2048px
Quality: 85
Convert to WebP: On

On Shopify

Use responsive images:

<img
  src="{{ image | image_url: width: 800 }}"
  srcset="
    {{ image | image_url: width: 400 }} 400w,
    {{ image | image_url: width: 800 }} 800w,
    {{ image | image_url: width: 1200 }} 1200w
  "
  sizes="(max-width: 600px) 400px, (max-width: 1200px) 800px, 1200px"
  loading="lazy"
/>

Shopify Theme Customization

Create Article Template Sections

Build flexible article templates:

{% comment %} sections/article-template.liquid {% endcomment %}

<article class="article">
  {% section 'article-hero' %}
  {% section 'article-meta' %}
  {% section 'article-content' %}
  {% section 'article-author' %}
  {% section 'article-related' %}
  {% section 'article-comments' %}
</article>

Display Custom Fields

Show synced metadata:

{% comment %} Reading time {% endcomment %}
{% if article.metafields.wash.reading_time %}
  <span class="reading-time">
    {{ article.metafields.wash.reading_time }} min read
  </span>
{% endif %}

{% comment %} Featured product {% endcomment %}
{% if article.metafields.wash.featured_product %}
  {% render 'featured-product',
    product: article.metafields.wash.featured_product.value
  %}
{% endif %}

Style for Consistency

Match WordPress block styles in Shopify CSS:

/* Match WordPress block styles */
.article-content figure {
  margin: 2rem 0;
}

.article-content figcaption {
  font-size: 0.875rem;
  color: #666;
  text-align: center;
  margin-top: 0.5rem;
}

.article-content blockquote {
  border-left: 4px solid #0066cc;
  padding-left: 1rem;
  margin: 1.5rem 0;
  font-style: italic;
}

Security Recommendations

WordPress Security

1. Strong passwords: Use password manager
2. Two-factor auth: Enable 2FA for all users
3. Limit logins: Use login limiting plugin
4. Keep updated: WordPress, plugins, themes
5. SSL: Use HTTPS everywhere

API Security

1. Regenerate keys: Periodically rotate API keys
2. Monitor access: Review API logs
3. IP restrictions: If possible, restrict API access
4. Minimal permissions: Only enable needed features

Shopify Security

1. Staff accounts: Use individual accounts
2. App permissions: Review app access regularly
3. Two-factor auth: Enable for all staff
4. Activity log: Monitor admin actions

Monitoring and Maintenance

Regular Checks

Task	Frequency
Review sync logs	Daily
Check for 404s	Weekly
Verify redirect function	Weekly
Update WordPress	Monthly
Rotate API keys	Quarterly
Full sync audit	Quarterly

Sync Health Dashboard

Monitor these metrics:

Sync Health
├── Success rate: 99.2%
├── Average sync time: 3.2s
├── Failed syncs (24h): 2
├── Images synced (24h): 45
└── Redirects active: 156

Error Handling

When syncs fail:

1. Check error logs
2. Identify pattern (specific posts? images?)
3. Test manually
4. Adjust settings
5. Retry failed syncs

Backup Strategy

WordPress Backups

Daily: Database backup
Weekly: Full site backup
Monthly: Off-site backup verification

Shopify Data

While Shopify handles hosting:

• Export articles periodically
• Keep WordPress as source of truth
• Document custom theme changes

Migration Checklist

Pre-Migration

• [ ] Audit existing WordPress content
• [ ] Clean up unused posts/images
• [ ] Verify all images have alt text
• [ ] Complete author profiles
• [ ] Plan category-to-blog mapping
• [ ] Test with sample content

During Migration

• [ ] Enable Smart Redirections
• [ ] Sync in batches
• [ ] Verify each batch
• [ ] Monitor for errors
• [ ] Check image uploads
• [ ] Test redirects

Post-Migration

• [ ] Submit new sitemap to Google
• [ ] Update Google Search Console
• [ ] Monitor 404 errors
• [ ] Check analytics for issues
• [ ] Update internal links (if any)
• [ ] Keep WordPress secure/hidden

Summary: Key Recommendations

1. Hide WordPress from public access
2. Block indexing with robots.txt
3. Enable redirections before syncing
4. Test thoroughly with sample content
5. Optimize images before and during sync
6. Monitor regularly for errors and 404s
7. Keep WordPress as your source of truth
8. Maintain security on both platforms
9. Document everything for your team
10. Plan for long-term redirect maintenance

---

Related Documentation

• Installation Guide
• Connection Settings
• Smart Redirections
• Shopify Limitations