# Site Setup
Site setup for GoldE Theme

# Ensure URL Rewrite Work
To make sure the multi-language plugin work properly, URL Rewrite feature should be enabled.
For Apache user, put `.htaccess` file into the root folder of WordPress

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /blog/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /blog/index.php [L]
</IfModule>

> /blog path may change to your WordPress root path

WordPress may auto detect your URL Rewrite setting. You may need to change the Site URL on WordPress Dashboard on:
- `Setting > General > Wordpress Address (URL)`
- `Setting > General > Site Address (URL)`
If the URL contain `index.php`, remove it.

# Install and Active Theme
To install GoldE Theme, you can place the golde theme folder in your WordPress folder `wp-content/themes`.

Or you can Upload a zip file on Dashboard `Appearance > Themes > Add New > Upload Theme`

> Please ensure that you have active GoldE Theme on Dashboard `Appearance > Themes` before going to next setup.

# Install Required Plugin

GoldE Theme has intergrated with few plugins. There are the required plugins:

- WPGolbus - The multi-language plugin
-
Also, there are some plugin that it's not required. But still recommanded to install.
- Classic Editor - WPGlobus Multi-language editor has some bug on new Editor. Change back to Classic Edtior for a better translation experience

If you want to use reCaptcha on contact form, you may install:
- Contact Form 7 - Contact Form Plugin
- Contact Form CFDB7 - Store contact form answer in Wordpress Dashboard
- ReCaptcha v2 for Contact Form 7 - Backward Support for ReCaptcha v2 on CF7

> Please ensure that you have active all the required plugin before going to next setup.

# Setup Pages
Setup the page with the follwing page template.
| Page | Template |
|--------------|--------------|
| Home | Front Page |
| How it works | How it works |
| News | News |
| Support | FAQ |
| About | About |
| Contact | Contact |

---
**=== If you are not planned to use Contact Form 7 (CF7), Ignore the part below ===**

# Setup Contact Form (With Contact Form 7 Plugin)

## 1. Setup reCAPTCHA on Contact Form
reCaptcha is important for prevent spam on contact form. To setup reCaptcha:
1. Go to Dashboard `Contact > Intergration`
2. Find `reCAPTCHA > Setup Intergration`
3. Setup the `Site Key` and `Secret Key`

> If you have ReCaptcha v2 Plugin Installed, use v2 Key instead of v3.



## 2.Setup Contact Form
You make setup 3 Contact Form for multiple language users. Add these form in Dashboard `Contact > Contact Form`

> You may remove `[recaptcha]` if you are using reCAPTCHA v3

EN Form:

[text* your-name placeholder "Name *"]
[tel* your-phone placeholder "Phone number *"]
[email your-email placeholder "Email"]
[textarea your-message placeholder "What can we help you?"]
[recaptcha]
[submit "Send"]

ZH_TW Form:

[text* your-name placeholder "名稱 *"]
[tel* your-phone placeholder "電話號碼 *"]
[email your-email placeholder "電子郵件"]
[textarea your-message placeholder "我們能為您提供什麼幫助？"]
[recaptcha]
[submit "發送"]

ZH_CN Form:

[text* your-name placeholder "名称 *"]
[tel* your-phone placeholder "电话号码 *"]
[email your-email placeholder "电子邮件"]
[textarea your-message placeholder "我们能为您提供什么帮助？"]
[recaptcha]
[submit "发送"]

If you are using Contact Form CFDB7 Plugin, you can disable the email function on contact form by adding this in the Addition Settings of Contact Form:

skip_mail: on

After setup the contact form, there will be a shortcode on the Contact Form list. Example:

[contact-form-7 id="63" title="GoldE Contact Form"]

> This is an example, copy on the contact form list instead of this.

## 3. Setup Contact Page
Edit the content of Contact page in Dashboard `Page > All Page > Contact`. Enter the shortcode in the page content. Make sure that you have setup the contact page for all the language.

> Different language may have different shortcode.

**=== End of CF7 Setting ===**

---

# Setup Menu
You make create a menu and add all page in the menus on Dashboard `Appearance > Menus`. Make sure that you have set the `Menu Settings > Display location` to GoldE Menu to apply the menu in the Theme.


# Setup Front Page
To make sure the website display properly, make sure you have set the homepage setting to a static page.

1. Go to Dashboard `Settings > Reading > Your homepage displays`
2. Set to `A Static Page`
3. Set Homepage to `Home`

# Other setup
The site should be setup properly now. For other setting (Post, Translate, Link Setting). Please refer to this Guide:

https://hackmd.io/@caxerx/rygiQQFMv