By default, WooCommerce supports taking payments through popular payment processors like PayPal and Stripe, as well as taking cash on delivery, cheque or BACS. Just like WordPress, it’s functionality can be vastly extended through plugins. These include everything, from additional payment processors like Amazon and SagePay, shipping tools like UPS and USPS, additional functionality like lessons, customised items, subscriptions and appointment bookings.

As well as our documentation about the basics of WooCommerce, you can find out more about setting up WooCommerce in their own documentation.

WooCommerce in the theme

The post What is WooCommerce? appeared first on WPlook Documentation.

The post Managing Orders appeared first on WPlook Documentation.

You can add new products through Products → Add Product in the WordPress Administration Panel.

Products contain most of the same options as standard posts. You can read about these in the Add New Post chapter. Additionally, they contain post options specific to products.

Product Options

The Product Data meta box is where the majority of important data is added for your products.

General section

• SKU: Stock keep unit (SKU) tracks products. Must be unique and should be formatted so it does not match any post IDs. For example, post IDs are numbers so a SKU could be WS01. That could stand for WooShirt 01.
• Price
  • Regular Price: Item’s normal/regular price.
  • Sale Price: Item’s discounted price that can then be scheduled for certain date ranges.

Inventory section

The inventory section allows you to manage stock for the product individually and define whether to allow back orders and more. If stock management is disabled from the settings page, only the Manage stock? option is visible.

Ticking the Sold Individually checkbox limits the product to one per order.

Shipping section

• Weight: Weight of the item.
• Dimensions: Length, width and height for the item.
• Shipping Class: Shipping classes are used by certain shipping methods to group similar products.

Linked Products section

Using up-sells and cross-sells, you can cross promote your products. They can be added by searching for a particular product and selecting the product from the dropdown list. After adding, Linked Products are displayed in the input field.

Up-sells are displayed on the product details page. These are products that you may wish to encourage users to upgrade, based on the product they are currently viewing. For example, if the user is viewing the coffee product listing page, you may want to display tea kettles on that same page as an up-sell.

Cross-sells are products that are displayed with the cart and related to the user’s cart contents. As an example, if the user adds a Nintendo DS to their cart, you may want to suggest they purchase a spare stylus when they arrive at the cart page.

Grouping: Used to make a product part of a grouped product. More info in the Grouped Products chapter of the WooCommerce documentation.

Attributes section

On the Attributes tab, you can assign details to a product. You will see a select box containing global attribute sets you created (e.g., platform). More in the Managing Product Categories, Tags and Attributes chapter of the WooCommerce documentation.

Once you have chosen an attribute from the select box, click add and apply the terms attached to that attribute (e.g., Nintendo DS) to the product. You can hide the attribute on the frontend by leaving the Visible checkbox unticked.

Custom attributes can also be applied by choosing Custom product attribute from the select box. These are added at the product level and won’t be available in layered navigation or other products.

Advanced section

• Purchase note: Enter an optional note to send the customer after they purchase the product.
• Menu order: Custom ordering position for this item.
• Enable Reviews: Enable/Disable customers reviews for this item.

Excerpt

Add a short product description. This typically appears next to product imagery on the listing page, and the long description appears in the Product Description tab.

Taxonomies

On the right-hand side of the Add New Product panel, there are product categories in which you can place your product, similar to a standard WordPress post. You can also assign product tags in the same way.

Product images

You can add a main image and a gallery of images. More in the Adding product image and galleries chapter of the WooCommerce documentation.

Setting catalog visibility and feature status

In the Publish panel, you can set catalog visibility for your product.

• Catalog and search: Visible everywhere, shop pages, category pages and search results.
• Catalog: Visible in shop pages and category pages, but not search results.
• Search: Visible in search results, but not in the shop page or category pages.
• Hidden: Only visible on the single product page – not on any other pages.

You can also tick the Featured Product box, to make this product visible in areas where such products are displayed, such as widgets etc.

The post Add New Product appeared first on WPlook Documentation.

Theme Options are a page in the WordPress Administration Panel which comes with this theme. It allows users to change theme settings without modifying theme files or knowing any code.

You can access Theme Options by going to WPlook Panel → Theme Options from the WordPress toolbar, or Appearance → Theme Options from the main menu.

The post What are Theme Options? appeared first on WPlook Documentation.

• Logo Image: The website logo, which will appear in the page header instead of a site title.

• Favicon: Brand your page with a custom favicon. Upload your favicon and use .png image type.
• Default header image: The header image to be displayed if a header image isn’t set for that specific post.
• Active Breadcrumb: Activate or deactivate the breadcrumbs, which are displayed on every page and show the user where they are on the site. They help the user navigate the site and help SEO (search engine optimization).
• Copyright: The text that will be displayed in the site footer.

The post General Settings appeared first on WPlook Documentation.

The General Settings section controls some of the most basic configuration settings for your site: your site’s title and location, who may register an account at your site, and how dates and times are calculated and displayed.

In order to access the general settings go to Settings → General.

Site title

Enter the name of your site (or blog) here. Most themes will display this title, at the top of every page, and in the reader’s browser titlebar. WordPress also uses this title as the identifying name for your syndication feeds (RSS).

Tagline

In a few words, explain what your site is about. Your sites’s slogan, or tagline, might be entered here. A tagline is short phrase, or sentence, used to convey the essence of the site and is often funny or eye-catching.

WordPress Address (URL)

Enter the full URL of the directory containing your WordPress core application files (e.g., wp-config.php, wp-admin, wp-content, and wp-includes). For example, if you installed WordPress into a directory called blog, then the WordPress address would be http://example.net/blog (where example.net is your domain). If you installed WordPress into your web root, this address will be the root URL http://example.net. WordPress will trim a slash (/) from the end.

Site Address (URL)

Enter the address you want people to type in their browser to reach your WordPress site. This is the directory where WordPress’s main index.php file is installed. The Site address (URL) is identical to the WordPress address (URL) (above) unless you are giving WordPress its own directory. WordPress will trim a slash (/) from the end.

E-mail Address

Enter the e-mail address to which you want WordPress to send messages regarding the administration and maintenance of your WordPress site.

For example, if you allow new users to register as a member of your site (see Membership below), then a notification will be sent through e-mail to this address. In addition, if the option, An administrator must always approve the comment, is set in Administration → Settings → Discussion, this e-mail address will receive notification that the comment is being held for moderation.

Please note this is different than the address you supplied for the admin user account; the admin account e-mail address is sent an e-mail only when someone submits a comment to a post by admin. The address you enter here will never be displayed on the site. You can send messages to multiple admins by using an email address which forwards email to multiple recipients.

Membership

Check the Anyone can register checkbox if you want anyone to be able to register an account on your site.

New User Default Role

This pull-down box allows you to select the default Role that is assigned to new users. This Default Role will be assigned to newly registered members or users added via the administration panel.

Timezone

From the pulldown box, choose a city in the same timezone as you. For example, under America, select New York if you reside in the Eastern Timezone of the United States that honors daylight savings times. If you can’t identify a city in your timezone, select one of the Manual Offsets that represents the number of hours by which your time differs from Greenwich Mean Time. Click the Save Changes button and the UTC time and “Local time” will display to confirm the correct Timezone was selected.

Date Format

The format in which to display dates on your site. This setting controls the format the theme displays dates in, but does not control how the date is displayed in the administrative panel. Select one of the proposed formats or see Formatting Date and Time in the WordPress documentation for more available formats.

Time Format

The format in which to display times on your site. This setting controls the format the theme displays times in, but does not control how the time is displayed in the administrative panel. Select one of the proposed formats or see Formatting Date and Time in the WordPress documentation for more available formats.

Week Starts On

Select your preferred start date for WordPress calendars from the drop-down box. Monday is the default setting for this drop-down, meaning a monthly calendar will show Monday in the first column. If you want your calendar to show Sunday as the first column, then select Sunday from the drop-down.

Site Language

The language for the WordPress administration panel as well as the front-end of the site. Read Configuring Site Language for information on how languages in WordPress work and how to translate the theme into your own language.

The post General Settings appeared first on WPlook Documentation.

Permalinks are the permanent URLs to your individual pages and blog posts, as well as your category and tag archives. A permalink is the web address used to link to your content. The URL to each post should be permanent, and never change — hence the name permalink.

The Settings → Permalinks screen allows you to choose your default permalink structure. You can choose from common settings or create custom URL structures. You must click the Save Changes button at the bottom of the screen for new settings to take effect.

By default, WordPress uses web URLs which have day and name in them; however, WordPress offers you the ability to create a custom URL structure for your permalinks and archives. This can improve the aesthetics, usability, and forward-compatibility of your links.

Common settings

Check one of the radio buttons corresponding to the correct Permalink Structure for your blog.

• Default: An example of the default structure is http://www.sample.com/?p=123, where the number represents the post ID.
• Day and name: An example of the day and name based structure is http://www.sample.com/2008/03/31/sample-post/.
• Month and name: An example of the month and name based structure is http://www.sample.com/2008/03/sample-post/.
• Numeric: An example of the numeric structure is http://www.sample.com/archives/123.
• Post name: An example of the post name structure is http://www.sample.com/sample-post.
• Custom structure: In the box specify the custom structure you desire to use. One example is /archives/%year%/%monthnum%/%day%/%postname%/.

While it’s most likely one of the default structures will be sufficient for your site, you can read about custom structures in the Structure Tags section of the WordPress documentation.

Optional

You may enter custom bases for your category and tag URLs here. For example, using /topics/ as your category base would make your category links like http://example.org/topics/uncategorized/. If you leave these blank the defaults will be used.

• Category base: Enter a custom prefix for your category URLs here.
• Tag base: Enter a custom prefix for your tag URLs here.

Saving your changes

Click the Save Changes button to ensure any changes you have made to your Settings are saved to your database. Once you click the button, a confirmation text box will appear at the top of the page telling you your settings have been saved. After you’ve clicked this button, you should receive one of two messages depending on whether your .htaccess file is writeable. For information on how to make .htaccess writeable, see Changing File Permissions.

If .htaccess is writeable, you will get a message that says “Permalink structure updated.” You’re all set; WordPress has been able to do everything for you automatically.

If .htaccess is not writeable, you will see a message at the top of the screen that says “You should update your .htaccess now.”.

Near the bottom of the screen you will see “If your .htaccess file were writable, we could do this automatically, but it isn’t so these are the mod_rewrite rules you should have in your .htaccess file. Click in the field and press CTRL + a to select all.” This means you’ll have to do one extra step yourself. In the text box at the bottom of the Screen, WordPress displays several lines of rewrite rules associated with the Permalink Structure you designated above. You need to manually copy everything in this text box into your .htaccess file to make your new Permalinks work.

Visiting the Permalinks screen triggers a flush of rewrite rules. There is no need to save just to flush the rewrite rules.

If you’re writing your .htaccess file on your own local computer, remember, some operating systems do not allow the creation of a file named “.htaccess” because of the initial dot (“.”). You can always name the file without the initial dot or with a standard extension (e.g. “htaccess.txt”). Once the file is uploaded to your weblog’s directory, rename it with your FTP software. Most FTP Clients should provide you a way to rename files this.

Files that begin with a dot (“.”) like “.htaccess” are hidden on most servers by default. Consult the userguide or FAQ of the FTP software you use to find out how to have the software display these hidden files, and also how to use the software to change file permissions, rename files, etc.

The post Permalinks appeared first on WPlook Documentation.

Contact forms in WPlook Studio themes are managed using the Contact Form 7 plugin. It’s a well established plugin, with support for many languages as well as other features which make it the chosen plugin to include in our themes, such as Google reCAPTCHA support for preventing spam. Follow the instructions in Required Plugins to install the plugin.

Most shared hosting accounts on which WordPress will run won’t have any problems sending emails – but if you do experience issues, check the Setting Up Mail article.

Adding Contact Forms

Individual contact forms in Contact Form 7 are managed in the Contact screen found in the navigation sidebar in the WordPress Administration Panel. This screen lists all available contact forms.

From here you can click Add New at the top of the screen to add a new form. You will be taken to the Edit Contact Form screen.

This screen is similar to WordPress’ standard Edit Post screen, however, it allows for editing forms rather than standard post content. To get started, give your new contact form a title.

Form

To add a new field to your form, enter the following at the point in the form text where you’d like the field to appear.

<label> Field Name </label>

Put the cursor just before the </label> tag, and click one of the buttons above the text area to add that type of field. The following field types are accepted:

• text: A standard, one line text input.
• email: An email field. Mobile users are given e-mail suggestions and a keyboard with e-mail specific characters and autocorrect is disabled.
• URL: A link field. Mobile users are shown a keyboard with URL specific characters and autocorrect is disabled.
• tel: A telephone number field. Mobile users are shown a number-only keyboard and phone number suggestions.
• number: A generic number field. Mobile users are shown a number-only keyboard.
• date: A date field. Both mobile and desktop users are shown a date picker.
• text area: A bigger input area for generic, longer text.
• drop-down menu: A dropdown menu with a selection of options, from which the user must pick one.
• checkboxes: A list of checkable boxes, of which the user can select multiple. Must be placed outside of the <label> tag.
• radio buttons: A list of checkable boxes, of which the user can select one. Must be placed outside of the <label> tag.
• acceptance: A checkbox for making the user accept terms and conditions.
• quiz: A single way of checking if the form submission is generated by a human or is spam. Displays an obvious question with a simple answer to it, to make sure the user is real.
• reCAPTCHA: A reliable way of checking if the submission is real or spam. Requires a Google account to create API keys for it.
• file: A file upload field.
• submit: A button for completing the form submission.

The pop-up window displayed after clicking on a button gives more options, such as whether the field will be required or not, as well as information about more specific field settings. For example, this is the window displayed when inserting a text field:

Most of the fields share common options, including the following:

• Field type: Check the box to mark this field as required.
• Name: The name of the field, used to refer to it in the email template.
• Default value: The default value of the input field. Check the Use this text as the placeholder of the field checkbox to have the text disappear once the user clicks the field.
• Id attribute: The ID of the field, used for customising the look of the field with CSS code.
• Class attribute: Space separated CSS classes of the field, used for customising the look of the field with CSS code.

Mail

The Mail section is where the settings for this form are stored. All of these fields accept the tags which are listed at the top of the section – these come from the names of the field you entered in the Form section.

• To: The recipient of the emails generated by the form. This is usually your own e-mail address.
• From: The sender of the email form, usually in the format [your-name] <wordpress@wordpress.dev>, where [your-name] is the tag used in the Form section for the user’s name, and <wordpress@wordpress.dev> is an e-mail address on your server. Using an e-mail address in the same domain as your WordPress installation helps prevent sent e-mails being detected as spam.
• Subject: The subject of the message sent.
• Additional Headers: Additional mail headers, for advanced purposes. A useful line to include here is Reply-To: [your-email], where [your-email] is the field containing the sender’s email. This makes your email client default to responding to the sender when you reply to a message sent from this contact form.
• Message Body: The content of the message. This is the place to include tags for fields set up in the Form section.
• File Attachments: A list of attachments included with this email. If you used a file field in your form, this is the place to include the tag with its’ name.

Messages

The Messages section contains strings for every possible response to the contact form – such as failures and successes. By default, they’re displayed in the language your site is set to, but you can customize them here.

Additional Settings

The area for additional code snippets used for customisation. Find out more in the Additional Settings article on the Contact Form 7 website.

Tips For Authoring Contact Forms

The default Contact Form 7 form largely does the job for most contact forms. However, here’s a few tips to keep in mind.

Make sure that unless you’re using multiple control elements, such as [checkbox], both the label and element tag are placed inside the <label></label> tags, as this aids accessibility. Doing this is demonstrated in Contact Form 7’s default form.

Also make sure to use either the [quiz] or [reCAPTCHA] elements, as these prevent your forms from being targeted by spam bots. ReCAPTCHA is the more reliable form of spam prevention, but it requires getting API keys from Google. Find out how to do this in the reCAPTCHA article on Contact Form 7’s website.

Displaying Contact Forms

To display a contact form, copy the shortcode with the blue background under the form title and paste it onto any of your posts or pages, for example, a page titled Contact.

The post Authoring Contact Forms appeared first on WPlook Documentation.

If the language you want to use for your site is not available, you can create the translation yourself. To do this, download the Poedit software for free from the Poedit website. They also offer a paid version specifically for WordPress, but you only need to download the free version from their homepage.

If you translated the theme in your language and want to share the translation with the community, just submit a ticket and we will include it in the next update. Thank you so much for your contribution!

The Translation Process

1. Once you’ve downloaded and installed PoEdit, launch it and click Create new translation.

2. Open the .pot file found in your theme’s languages/ directory.

3. Select the language of your translation.

4. Go to File → Save As… and save the file in the theme’s languages/ directory using a filename taken from the WP Locale column of the Translate WordPress page. For example, if your site is set to French, use fr_FR.po as your filename, or if your site is set to a more specific language, like English (UK), use en_GB.po.

5. Translate each of the strings in the top window by typing it’s translation into the text area at the bottom of the window.

• You might encounter some strings which contain things like %d, %s, or %1$s. These are simply placeholders for non-static items, such as dates or numbers. Strings may also occasionally contain HTML. Copy these exactly into the translated phrase in the appropriate place.

• Some strings, usually those including placeholders, include context, so you know what the placeholders represent and you can translate it so it makes sense in your language. This is displayed above the Source text textbox.

• You might also encounter strings which include singular and plural versions. Click the Singular or Plural tabs in Poedit to edit the respective versions of this string.

6. Once you’ve finished your translation, export your translation as a .mo file. To do this, go to File → Compile to MO…. Save this alongside your original translation file, using the same language code, resulting in a name such as fr_FR.mo.

7. To enable your translation in WordPress, follow the steps in Configuring Site Language.

Updating Translations

If you’ve done a translation for a previous version of the theme, you will need to update it when theme updates are released. Nearly every theme update adds new strings or removes obsolete strings. To do this, open your existing .po file and go to Catalogue → Update from POT File… and select the .pot file from the latest version of the theme.

The post Translating The Theme appeared first on WPlook Documentation.

WordPress uses a single setting to control the language of the administration panel, plugins and themes. If the files for your chosen language exist in the theme, WordPress will automatically use them.

The theme supports English and French out of the box. It’s easy to add your own languages — see how to do this on the How To Add a New Language page.

You can set the site language of your WordPress installation in Settings → General.

WordPress Administration Panel → Settings → General

The post Configuring Site Language appeared first on WPlook Documentation.