Installation Guide

Prerequisites

Before installing ShahiTranslate Pro, ensure your WordPress installation meets the following requirements:

1. WordPress Version: 5.0 or higher
2. PHP Version: 7.4 or higher (PHP 8.0+ recommended)
3. MySQL Version: 5.6 or higher
4. Web Server: Apache or Nginx with mod_rewrite enabled
5. Memory Limit: At least 128MB (256MB recommended)

Installation Steps


Method 1: Manual Upload via WordPress Dashboard


6. Download the Plugin

– Obtain the shahitranslate-pro.zip file from your purchase email or account dashboard

7. Upload to WordPress

– Log in to your WordPress admin panel
– Navigate to Plugins → Add New
– Click the Upload Plugin button at the top
– Click Choose File and select the downloaded ZIP file
– Click Install Now

8. Activate the Plugin

– After installation completes, click Activate Plugin
– You’ll be redirected to the plugins page with ShahiTranslate Pro now active

Method 2: FTP/SFTP Upload


9. Extract the ZIP File

– Unzip shahitranslate-pro.zip on your local computer
– You should see a folder named shahitranslate-pro

10. Upload via FTP

– Connect to your server using an FTP client (FileZilla, WinSCP, etc.)
– Navigate to /wp-content/plugins/
– Upload the entire shahitranslate-pro folder to this directory

11. Activate the Plugin

– Log in to WordPress admin panel
– Go to Plugins → Installed Plugins
– Find ShahiTranslate Pro and click Activate

Post-Installation Steps


1. Initial Configuration


After activation, you’ll see a welcome screen or notification:

12. Click on ShahiTranslate Pro in the admin menu
13. You’ll be taken to the Settings page
14. Configure your basic settings (detailed in the Configuration Guide)

2. API Key Setup (If Using Google Translate)


If you plan to use Google Translate API:

15. Obtain a Google Translate API key from Google Cloud Console
16. Navigate to ShahiTranslate Pro → Settings → API Settings
17. Enter your API key and save

3. Choose Your Languages


18. Go to ShahiTranslate Pro → Settings → Languages
19. Select your default/source language
20. Choose the languages you want to offer translations for
21. Save your settings

4. Configure Language Switcher


22. Navigate to ShahiTranslate Pro → Settings → Switcher
23. Choose your preferred switcher style (dropdown, flags, globe, popup, etc.)
24. Customize appearance and position
25. Save settings

Verifying Installation


To confirm ShahiTranslate Pro is working correctly:

26. Visit your website’s front end
27. Look for the language switcher in the configured position
28. Try switching languages
29. Verify content is being translated

Database Tables


Upon activation, ShahiTranslate Pro automatically creates the following database tables:

30. wpstptranslations – Stores cached translations
31. wpstpmanual_translations – Stores manual translation overrides
32. wpstplanguage_settings – Stores language-specific configurations

These tables are created automatically and require no manual intervention.

Troubleshooting Installation


Plugin Won’t Activate


33. Check PHP Version: Ensure your server meets minimum PHP requirements
34. Check File Permissions: Verify the plugin folder has correct permissions (755 for directories, 644 for files)
35. Check for Conflicts: Temporarily deactivate other plugins to identify conflicts

Missing Dependencies


If you see errors about missing files:

36. Re-upload the plugin ensuring all files are transferred
37. Verify the vendor folder is present and complete
38. Check that autoload.php exists in the vendor folder

Database Errors


If you encounter database-related errors:

39. Verify your WordPress database user has CREATE and ALTER privileges
40. Check the error log in Tools → Site Health → Info → Database
41. Contact your hosting provider if permissions issues persist

Next Steps


Now that ShahiTranslate Pro is installed, proceed to:

42. Quick Start Guide
43. Basic Configuration
44. Choosing Your Translation Method