Zippixa – Image Compressor & File Size Reducer WordPress Theme

1. Welcome

Thank you for choosing Zippixa. This documentation explains how to install, configure, customize, and maintain the theme.

2. System Requirements

Input and output format behavior depends on the visitor’s browser implementation. Test JPG, PNG, and WebP workflows in the browsers most relevant to your audience.

3. Package Contents

The installable package contains the zippixa theme folder. Important files include:

4. Theme Installation

WordPress dashboard method

1. Sign in to WordPress and open Appearance → Themes.
2. Select Add New Theme → Upload Theme.
3. Choose the installable zippixa-v1.5.0.zip file.
4. Select Install Now, then Activate.
5. Visit the homepage and clear any page cache if the previous theme remains visible.

Manual method

1. Extract the package on your computer.
2. Upload the zippixa folder to /wp-content/themes/.
3. Open Appearance → Themes and activate Zippixa.

5. Quick Start Checklist

1. Activate Zippixa.
2. Open Appearance → Customize → Site Identity and upload a logo or site icon.
3. Open Appearance → Customize → Zippixa Homepage and review the brand name, hero text, SEO title, meta description, social image, and accent color.
4. Create and assign the Primary and Footer menus under Appearance → Menus.
5. Configure advertisements under Appearance → Responsive Ads.
6. Open Settings → Permalinks and save the preferred URL structure.
7. Test image compression and downloads on desktop and mobile.

6. Homepage Structure

The homepage is designed around image-compression search intent and user conversion. Its sections include:

Homepage fallback navigation links to internal anchors such as #compressor, #features, #how-it-works, #use-cases, #image-compression-guide, and #faq.

7. Image Compressor Tool

Supported workflow

1. Select or drag JPG, PNG, or WebP images into the upload area.
2. Adjust quality, output format, maximum dimensions, aspect-ratio preservation, and optional target size.
3. Select Reduce file sizes.
4. Review original size, output size, and savings.
5. Download files individually or use the batch download control.

8. Theme Customizer

Open Appearance → Customize.

9. Header, Footer, and Menus

Assign menus under Appearance → Menus → Manage Locations.

When dedicated footer menus are not assigned, the theme provides sensible fallback links. Widgets can be added under Appearance → Widgets → Footer Widgets.

10. Responsive Ads System

Open Appearance → Responsive Ads.

1. Enable the responsive ads system.
2. Enter a valid Google AdSense publisher ID in the form ca-pub-1234567890123456.
3. Paste the ad-unit HTML into the required Top, Left, Right, or Bottom field.
4. Set reserved width and height values.
5. Choose whether each placement should be hidden on smaller screens.
6. Save the settings and verify the frontend while signed out.

Empty ad fields remain hidden. The theme can render administrator-supplied HTML, JavaScript, iframe, image, or shortcode content. Only trusted administrators should be permitted to save executable advertising code.

11. Timed Popup Ads

The popup is configured from the same Appearance → Responsive Ads page.

The default popup frequency is once per browser session. Frequency state is stored in the visitor’s browser.

12. SEO Features

Zippixa provides the following homepage SEO output when a supported SEO plugin is not active:

Automatic duplicate-output protection checks for Yoast SEO, Rank Math, All in One SEO, and SEOPress. When one of these plugins is active, configure metadata and schema inside that plugin.

13. Shortcode and Page Template

Shortcode

Add the compressor to a page or post:

[zippixa_tool]

Dedicated page template

1. Create or edit a WordPress page.
2. Open the page template setting.
3. Select Zippixa Image Compressor.
4. Publish the page.

The theme loads the compressor JavaScript only on the homepage, the dedicated template, or content containing the [zippixa_tool] shortcode.

14. Blog, Pages, and WordPress Content

Zippixa includes standard templates for posts, pages, search results, comments, and 404 pages. It supports:

Featured imagesThreaded commentsResponsive embedsCustom logoWide alignmentHTML5 markupFooter widgets

To create a blog index, create an empty page named “Blog” and assign it under Settings → Reading → Posts page. The homepage can then show optional latest guide posts and a Blog navigation link.

15. Privacy, Security, and Performance

Image privacy

Selected images remain in browser memory during the active page session and are processed through browser APIs. They are not submitted to WordPress by the bundled reducer.

Security

• Keep WordPress, PHP, plugins, and the theme updated.
• Allow only trusted administrators to manage advertising code.
• Use HTTPS and a reputable hosting provider.
• Back up files and the database before updates or code changes.

Performance

• Use a cache plugin compatible with your hosting environment.
• Do not delay or combine reducer.js in a way that breaks the compressor.
• Exclude popup or AdSense scripts from aggressive JavaScript rewriting when ads fail to initialize.
• Optimize uploaded site images even though visitor-selected compressor files are not stored.

16. Translation

The theme text domain is zippixa. User-facing PHP strings are translation-ready through standard WordPress gettext functions.

1. Create a languages directory inside the theme if one is not present.
2. Generate a translation template from the zippixa text domain using a compatible localization tool.
3. Create the required .po and .mo files for the target locale.
4. Store translations safely in a child theme or translation plugin when update persistence is required.

17. Updating Zippixa

1. Create a complete file and database backup.
2. Record custom code and template changes.
3. Activate a maintenance window or staging site when appropriate.
4. Upload the new theme version through WordPress or replace the theme folder manually.
5. Clear server, plugin, browser, and CDN caches.
6. Test the homepage, compressor, downloads, menus, ad placements, popup frequency, and mobile layout.

18. Troubleshooting

19. Developer Notes

Use a child theme for template or stylesheet modifications. Preserve escaping, sanitization, nonce, capability, and WordPress coding-standard practices when extending administrator settings.

21. Support, License, and Credits

Before requesting support, include the WordPress version, PHP version, browser, theme version, relevant page URL, screenshots, browser-console errors, and a clear reproduction sequence. Never include passwords, private keys, or account credentials.