BlueTheme Docs فارسی

Blog, Portfolio & Shop

Where: Theme Options → Blog, Portfolio & Shop

Blog archive

Option Type Default Details
Layout Choice Grid Choices: Grid · Masonry · Classic · List · Timeline · Photo (title over image).
Columns Number Desktop: 2 · Tablet: 2 · Mobile: 1 Per device.
Posts per page Number 0 0 uses Settings → Reading.
Sidebar List Sidebar at the end Choices: No sidebar · Sidebar at the start · Sidebar at the end.
Which sidebar Sidebar sidebar-1
Category filter bar On / off Off
Leave these categories out of the blog Categories — Their posts still have their own category archive.
Excerpt length Number 24
"Read more" List Link Choices: Link · Button · Hidden.
Show Several choices Date, Author, Categories Choices: Date · Author · Categories · Tags · Comment count · Reading time.
Featured image On / off On
Image aspect ratio List 3:2 Choices: Original · 16:9 · 4:3 · 3:2 · 1:1 · 3:4.
Fade posts in while scrolling On / off Off
Pagination List Page numbers Choices: Page numbers · Previous / next · "Load more" button · Infinite scroll.

Single post

Option Type Default Details
Layout Choice Standard A Single post template (Templates) replaces this layout on the posts it matches. "Builder template" shows the standard layout where none matches. Choices: Standard · Full-width image above the title · Title over the image · Minimal (no image) · Builder template.
Sidebar List Sidebar at the end Choices: No sidebar · Sidebar at the start · Sidebar at the end.
Which sidebar Sidebar sidebar-1
Show Several choices — Choices: Featured image · Date · Author · Categories · Tags · Comment count · Reading time.
Share box position List After the content Turn the share box on for posts in Social → Share box. Choices: Under the title · After the content · Floating at the side.
Author box On / off On
Previous / next post List Titles only Choices: With thumbnails · Titles only · Hidden.
Related posts On / off On
Number of related posts Number 3
Related posts columns List 3 Choices: 2 · 3 · 4.
Related by List Categories Choices: Categories · Tags.
Comments On / off On Off hides comments on all posts, whatever each post's Discussion settings say.
Reading progress bar On / off Off A thin bar at the top of the screen. Its color is in Colors → Extras.

"Love" button

Option Type Default Details
Show the "Love" button On / off Off Visitors can love a post once; the count is stored with the post. Its colors are in Colors → Extras.
Position on posts List With the post details Choices: With the post details · After the content.
Show the count in archives too On / off On

Portfolio archive

Projects are added under Portfolio in the admin menu. These settings shape the portfolio archive, project category and tag pages, and project pages.

Option Type Default Details
Portfolio address base Text portfolio Lowercase letters, numbers and dashes. Links update when you save.
Category address base Text portfolio-category
Tag address base Text portfolio-tag
Portfolio page Page 0 The page that lists your projects, used in breadcrumbs.
Layout Choice Grid Choices: Grid · Masonry · Masonry, no gaps · List · Photo.
Columns Number Desktop: 3 · Tablet: 2 · Mobile: 1 Per device.
Projects per page Number 12
Order by List Date Choices: Date · Title · Custom order · Random.
Order List Newest / Z to A first Choices: Newest / Z to A first · Oldest / A to Z first.
Category filters On / off On
Filter style List Buttons Choices: Buttons · Underlined links · Dropdown.
Filter without reloading the page On / off On
Hover style List Zoom with icons Choices: Zoom with icons · Title over the image · Details slide up · Minimal · Color overlay.
On hover show Several choices Title, Categories, Link icon, Zoom icon Choices: Title · Categories · Link icon · Zoom icon.
Image aspect ratio List 4:3 Choices: Original · 16:9 · 4:3 · 3:2 · 1:1 · 3:4.
Pagination List Page numbers Choices: Page numbers · "Load more" button · Infinite scroll.

Single project

Projects are added under Portfolio in the admin menu. These settings shape the portfolio archive, project category and tag pages, and project pages.

Option Type Default Details
Layout List Image on top, details below Choices: Image on top, details below · Details beside the images · Full-width gallery · Image slider · Builder template.
Details side List End side Choices: Start side · End side.
Show Several choices — Choices: Client · Date · Task · Website link · Categories · Share box · Previous / next project · Related projects.
Number of related projects Number 3
"Love" button on projects and in the portfolio hover On / off Off

Shop catalog

Needs WooCommerce.

Option Type Default Details
Layout List Grid Choices: Grid · List.
Products per page Number 12
Products per row Number Desktop: 4 · Laptop: 3 · Tablet: 2 · Mobile: 2 Per device.
Sidebar List Sidebar at the start Choices: No sidebar · Sidebar at the start · Sidebar at the end.
Filters in a slide-out panel on mobile On / off On
Product card List Default Choices: Default · Card with border · Minimal · Buttons over the image.
Image hover List Show the second image Choices: Show the second image · Zoom · None.
Show on cards Several choices — Choices: Rating · Price · Categories · Add to cart · Quick view button · Wishlist button.
Add-to-cart button List Always visible Choices: Always visible · On hover.
Image aspect ratio List 1:1 Choices: Original · 16:9 · 4:3 · 3:2 · 1:1 · 3:4.
Sale badge shape List Pill Choices: Circle · Square · Ribbon · Pill.
Sale badge text List Discount percentage Choices: "Sale" · Discount percentage.
"New" badge for products newer than Number 0 0 turns the badge off.
Pagination List Page numbers Choices: Page numbers · "Load more" button · Infinite scroll.
Catalog mode On / off Off Show products without selling them online.
Hide prices On / off Off
Inquiry button text Text —
Inquiry button link Text — A page, tel: or mailto: link, or a WhatsApp/Telegram link. Empty hides the button.

Single product

Needs WooCommerce.

Option Type Default Details
Layout List Default A Single product template (Templates) replaces this layout on the products it matches. Choices: Default · Wide gallery · Sticky summary · Stacked gallery.
Gallery thumbnails List Below Choices: Below · Start side · End side · Hidden.
Zoom on hover On / off On
Open images in a lightbox On / off On
Description and reviews List Tabs Choices: Tabs · Accordion · All sections open.
Show Several choices — Choices: SKU · Categories · Tags · Share box · Related products · Upsells.
Related products Number 4
Related products per row Number 4
Sticky add-to-cart bar List Mobile only Choices: Off · Mobile only · All devices.
Variation swatches On / off On
Default swatch type List Label Choices: Dropdown · Label · Color · Image.
Swatch shape List Circle Choices: Circle · Square.
Swatch size Number 32

Cart, checkout & extras

Needs WooCommerce.

Option Type Default Details
Side cart drawer On / off On
Open the side cart after adding a product On / off On
Add to cart without reloading on product pages On / off On
Cart layout List Two columns Choices: Default · Two columns.
Checkout layout List Two columns Choices: Default · Two columns · Distraction-free (no header or footer).
Quick view On / off On
Wishlist List Built in Choices: Built in · YITH WooCommerce Wishlist · Off.
Wishlist page Page 0
Iranian province and city dropdowns On / off On Turns itself off when Persian WooCommerce is active, which has its own.
Persian address field order On / off On

Account & login

Login methods

Option Type Default Details
Email or username and password On / off On
One-time code by SMS On / off Off
One-time code by email On / off Off
Registration List Both Choices: Mobile number and one-time code (no password) · Email and password · Both.
Shown first List One-time code Choices: One-time code · Password.
Login form appears in Several choices My Account page, Checkout (returning customers), Popup from the header account icon Choices: My Account page · Checkout (returning customers) · Popup from the header account icon.
Add "Log in with a one-time code" to wp-login.php On / off Off The normal password form always stays there, so administrators can still log in if SMS fails.
Save the verified mobile number to the profile and billing phone On / off On
Step aside for Digits, Persian WooCommerce SMS or WP SMS On / off On When one of them is active, the theme hides its own one-time code form and styles theirs instead.

One-time codes

Option Type Default Details
Test mode On / off Off Codes are not sent by SMS or email; administrators see the latest ones below. For trying the forms only: turn it off on a live site.
Code length Number 5
Code expires after Number 120
Wait before sending again Number 60
Most codes per hour for one number Number 5
Most codes per hour from one IP address Number 10

SMS gateway

Option Type Default Details
Provider List Kavenegar Choices: Kavenegar · Melipayamak · IPPanel (FarazSMS) · SMS.ir.
API key Password —
Username Text —
Password or API key Password —
Sender line number Text —
Pattern (template) ID Text — For providers that send codes through an approved pattern. Leave empty to send the message below.
Code variable in the pattern Text — The name of the code placeholder in your pattern. Empty: "code" for IPPanel, "CODE" for SMS.ir. Kavenegar uses its token and Melipayamak the first variable.
Message Long text — {code} is replaced with the code; {site} with the site name.
Test mobile number Text — Save, then send a test: a real SMS with a sample code, sent through the settings above.