MokoWaaS Platform

MokoWaaS is the core site management suite for Joomla WaaS environments. Includes an admin dashboard, Web Application Firewall, tenant restrictions, security hardening, health monitoring, Grafana integration, and REST API.

Read more →

Adding and Editing Modules

Details
Category: MokoWaaS Platform

What Are Modules?

Modules are the building blocks that appear in specific positions around your pages — sidebars, headers, footers, and more. They display things like search bars, menus, recent articles, custom HTML content, images, and social media links.

Viewing Your Modules

  1. Go to Content > Site Modules in the top menu.
  2. You'll see a list of all modules with their position, status, and type.
  3. Use the Position filter to see modules assigned to a specific area of your site.

Editing a Module

  1. Click the module title to open it.
  2. Update the content, title, or settings as needed.
  3. Click Save & Close.

Common Module Types

  • Custom HTML — A free-form block where you can add any text, images, or HTML content. Great for announcements, sidebar content, or footer text.
  • Menu — Displays a navigation menu in a specific position.
  • Latest Articles — Shows your most recent articles from a selected category.
  • Search — Adds a search bar to your site.
  • Breadcrumbs — Shows the visitor's current location in your site hierarchy.

Module Positions

Each module is assigned to a position in your site's template. Common positions include:

  • sidebar-left / sidebar-right — Side columns next to your main content.
  • footer — The bottom section of every page.
  • topbar — Above the main navigation.
  • banner — Full-width area below the header.

Tips

  • You can restrict modules to specific pages using the Menu Assignment tab — show a sidebar only on your blog, for example.
  • Unpublish a module to hide it without deleting it.
Hits: 6

Article Creation

Details
Category: MokoWaaS Platform
  • Applicable Software: MokoWaaS (Joomla)
  • Applicable Version: v1.0.0

✍️ Share your story! MokoWaaS, powered by Joomla, makes it simple to create and edit articles on your site. Here’s a detailed walkthrough to help you master article creation.

Introduction

Articles are the main content type in MokoWaaS. They can be used for blog posts, news, announcements, or general pages. This guide shows you how to create, edit, and optimize them for your site.

Notice: Always start headings at <h3>. The system automatically uses <h1> and <h2> for article titles and system-level headings. This ensures consistency and prevents conflicts.

Creating an Article

  1. Log in to the administrator panel of your MokoWaaS site.
  2. Go to Content > Articles > New.
  3. Enter a clear, descriptive title.
  4. Write your article in the body area. Use the editor toolbar to:
    • Format text with headings, bold, or lists.
    • Insert images or media from the Media Manager.
    • Add links to internal or external pages.
  5. Assign the article to a category (e.g., Blog, News, Services) to keep your site organized.
  6. Set metadata for SEO (title, description, keywords).
  7. Include a social-safe intro image and intro text: Each article should have an eye-catching intro image sized correctly for social media (e.g., 1200x630px) and an intro text snippet. These are used in previews when your article is shared on social platforms via Perfect Publisher Pro. These requirements are essential for SEO and social optimization.
  8. Click Save & Close to save your article into the workflow process, or Save as Draft to continue later.

Editing an Article

  1. Go to Content > Articles.
  2. Find the article you want to edit using the search bar or filters.
  3. Click its title to open it in the editor.
  4. Make your changes, then click Save & Close to re-enter the workflow.

Advanced Options

  • Featured Articles: Mark an article as featured to display it on your homepage or key modules.
  • Access Levels: Restrict articles to certain user groups (e.g., registered users only).
  • Scheduling: Use the Publishing Options tab to set start and end dates for when an article should appear.
  • Version Control: Review the article history and restore previous versions if needed.

Workflows

All MokoWaaS sites are configured to use Joomla’s built-in publishing workflows by default. This ensures every article passes through a clear approval process before it is published. Workflows are essential for quality control and team collaboration.

  • Draft: Authors create and save their work-in-progress.
  • Review: Editors or managers review the draft, suggest changes, and approve it.
  • Publish: Once approved, the article goes live on the site automatically.
  • Unpublish/Archive: Articles can later be unpublished or archived while keeping them in the system for reference.

Workflows cannot be disabled in MokoWaaS, ensuring that all content follows an approval process. However, you can customize the steps under Content > Workflows, assigning specific roles and permissions for each stage.

Workflow Diagram

The typical article workflow looks like this:

Draft → Review → Publish → (Optional: Unpublish/Archive)

This simple diagram shows the journey of every article, making it easy to understand how content moves from creation to publication.

Tips

  • Use the Read More separator (<hr id='system-readmore' />) to create previews on blog or category pages.
  • Add engaging images and use alt text for accessibility and SEO.
  • Always include a properly sized social-safe intro image and short intro text to maximize engagement on social shares and improve SEO results.
  • Organize content into categories and subcategories for easy navigation.
  • Keep paragraphs short and scannable for better readability.
Hits: 5

Basic SEO: Titles, Descriptions, and URLs

Details
Category: MokoWaaS Platform

What is SEO?

SEO (Search Engine Optimization) is the practice of making your website easier for Google and other search engines to find, understand, and rank. Good SEO means more visitors finding you organically — without paid ads.

The Three Basics You Control

1. Page Titles

The title of your article becomes the page title in search results. It's the first thing people see.

  • Keep titles under 60 characters so they don't get cut off in search results.
  • Include your main keyword naturally — e.g., "Affordable Web Design for Nonprofits" instead of just "Our Services".
  • Make titles descriptive and specific.

2. Meta Descriptions

The meta description appears below the title in search results. It's your elevator pitch.

  1. In the article editor, go to the Publishing tab.
  2. Fill in the Meta Description field.
  3. Keep it under 160 characters.
  4. Summarize what the page is about and include a call to action.

3. URL Aliases

The alias determines your page's URL. For example, an article titled "Our Team" with alias our-team creates the URL yourdomain.com/our-team.

  • Joomla generates aliases automatically, but you can edit them.
  • Use lowercase words separated by hyphens: web-design-services.
  • Keep URLs short and descriptive.
  • Avoid changing URLs for published pages — it breaks existing links and search rankings.

Additional SEO Tips

  • Use headings properly — H2 for main sections, H3 for subsections. Search engines use these to understand your content structure.
  • Add alt text to images — Describe what the image shows in a few words.
  • Link to other pages on your site — Internal links help search engines discover and rank your content.
  • Write for humans first — Natural, helpful content always outperforms keyword-stuffed text.
Hits: 4

Creating and Editing Articles

Details
Category: MokoWaaS Platform

Articles Are Your Main Content

In MokoWaaS, articles are the building blocks of your website. Every page of text, every blog post, every service description — they're all articles. Learning to create and edit them is the most important skill for managing your site.

Creating a New Article

  1. Go to Content > Articles in the top menu.
  2. Click the + New button.
  3. Enter a Title for your article.
  4. Write your content in the text editor (see the Formatting Content article for editor tips).
  5. Choose a Category from the dropdown to organize your article.
  6. Set the Status to Published when you're ready for it to go live.
  7. Click Save or Save & Close.

Editing an Existing Article

  1. Go to Content > Articles.
  2. Find the article you want to edit — use the search bar or filter by category.
  3. Click the article title to open it.
  4. Make your changes in the editor.
  5. Click Save or Save & Close.

Article Status Options

  • Published — Visible on your site to visitors.
  • Unpublished — Saved but hidden from the public. Great for drafts.
  • Trashed — Marked for deletion. Can be recovered until permanently deleted.
  • Archived — Removed from active display but preserved for reference.

Tips

  • Use Save to keep working on the article. Use Save & Close to save and return to the article list.
  • If another user is editing an article, it will show as checked out. You may need to ask them to close it, or contact Moko Consulting to unlock it.
Hits: 5

Formatting Content with the Text Editor

Details
Category: MokoWaaS Platform

Using the Text Editor

MokoWaaS includes a powerful visual text editor that works similarly to a word processor. You don't need to know HTML — just type, format, and publish.

Basic Formatting

  • Bold — Select text and click the B button (or press Ctrl+B).
  • Italic — Select text and click the I button (or press Ctrl+I).
  • Headings — Use the Paragraph dropdown to apply Heading 2, Heading 3, etc. Heading 1 is typically reserved for the article title.
  • Lists — Use the bullet list or numbered list buttons for organized content.
  • Links — Select text, click the chain-link icon, and paste the URL.

Inserting Images

  1. Place your cursor where you want the image.
  2. Click the Insert Image button in the editor toolbar.
  3. Browse or upload an image from your Media Manager.
  4. Add alt text (a short description of the image for accessibility and SEO).
  5. Click Insert.

Creating Links

  • External links — Paste the full URL (e.g., https://example.com).
  • Internal links — Use the article selector to link to other pages on your site.
  • Email links — Use mailto: as the URL.

What to Avoid

  • Don't paste directly from Microsoft Word — It brings hidden formatting that can break your layout. Use the Paste as Plain Text button or paste into Notepad first.
  • Don't use Heading 1 — It's reserved for the page title. Start with Heading 2 for your sections.
  • Avoid excessive bold or colored text — Keep it clean and readable.
Hits: 5
  1. Getting Started - WaaS
  2. Keeping Your Site Secure: Best Practices
  3. Logging Into Your MokoWaaS Dashboard
  4. Managing Contact Forms and Submissions