CodeCanyon PerfexWiki - WordPress Plugin
The plugin is a robust educational course management solution for WordPress websites. With versatile features tailored for seamless course creation, organization, and delivery, it offers a user-friendly interface that simplifies the process for both administrators and learners. Notable functionalities include content management tools, assessment capabilities, and interactive communication channels to enhance the overall learning experience.

Plugin Features
Its intuitive course builder empowers administrators to create engaging learning materials effortlessly. The plugins drag-and-drop functionality, coupled with customizable templates, allows for the quick and efficient setup of courses tailored to specific educational needs. This streamlines the content creation process and ensures a dynamic learning environment for users.
Administrators benefit from comprehensive tracking and analytics tools that provide valuable insights into user engagement and course performance. These analytics help in optimizing course content, identifying areas for improvement, and enhancing overall learning outcomes. With seamless integration with WordPress, the plugin offers a unified platform for managing educational content efficiently.
Learners can enjoy a personalized learning journey with features such as progress tracking, quizzes, and discussion forums. The plugin facilitates interactive learning experiences through multimedia support and collaborative tools, fostering engagement and knowledge retention. Its responsive design ensures a seamless user experience across devices, enabling learning on the go.
The plugins built-in communication tools enable real-time interaction between instructors and learners, fostering a sense of community within the learning environment. From announcement boards to direct messaging, these features facilitate open communication channels essential for effective knowledge sharing and support. This enhances the overall educational experience and promotes active participation.
With seamless integration with popular WordPress plugins and themes, it offers scalability and flexibility for customization. This interoperability allows for enhanced functionality through third-party extensions, expanding CodeCanyon PerfexWiki capabilities to meet diverse educational requirements. The plugins versatility and user-centric design make it a valuable asset for educational institutions, corporate training programs, and online course creators looking to deliver quality learning experiences.
Specifications:
| Release date: | 11-10-2020 | |
| Last updated: | 25-06-2021 | |
| Type: | Paid | |
| License: | GPL | |
| Subject: | Site Management | |
| Compatibility: | W5.x | |
| Includes: | Plugin | |
| Language packs: |
|
|
| Developer: | CodeCanyon | |
| Rating: | ||
Share with your friends!
CodeCanyon PerfexWiki Usage and Configuration Guide
This guide to CodeCanyon PerfexWiki will help you understand the module's scope, prepare a secure knowledge base within Perfex CRM, establish a clear publication workflow, and verify that each employee or visitor sees only the information intended for them. Rather than repeating a promotional feature list, it provides a practical path: from reviewing an existing Perfex CRM installation and assigning permissions to publishing a first article, using an article map, enabling public access, and diagnosing a failed publication.
First, it is important to clarify a point that prevents the most common mistaken expectation. Despite the page category, PerfexWiki is positioned by its developer as a module for Perfex CRM, not as a standalone script or a regular WordPress plugin. It runs within an installed CodeIgniter-based CRM. For that reason, this guide does not include WordPress dashboard steps, Gutenberg blocks, or theme settings: they are unrelated to the product and would only confuse an administrator.
The purpose of PerfexWiki is to make knowledge part of everyday CRM work. Instead of scattered instructions in chats, personal folders, and outdated documents, the team gets one place for procedures, answers to recurring questions, service descriptions, onboarding instructions, and internal case reviews. The product page lists an internal knowledge base, content publishing and sharing, an article map, automatic navigation, bookmarks, full-screen editing, and a mind-map article type. Those capabilities become useful only when every piece of content has an owner, an audience, and a clear status.
The operational problem an internal knowledge base solves
PerfexWiki does not replace the CRM, nor is it meant to become a file archive for everything. Its sensible role is to quickly give a team member the answer they need while handling a lead, deal, project, support request, or internal approval. That might be a lead qualification process, a response template, a project handoff rule, a service description, a pre-publication checklist, or guidance for an unusual case. A good article reduces repeated questions without turning into an endless encyclopedia.
Imagine an agency where a new account manager receives an inquiry about building a website. They need to determine the scope of work, timeline, required client information, handoff conditions for production, and an approved answer to a support question. If that information lives across five chats, the outcome depends on a senior colleague's memory. If it is collected in one article, the employee follows a verified path and the manager updates it in one place. That repeatability, rather than the editor itself, is the measurable benefit of implementation.
When the module is especially useful
The greatest benefit comes to teams where the same actions are performed regularly but not always to the same standard. This includes sales teams handling common objections, support teams with escalation rules, agencies with recurring project stages, internal departments with procedures, and companies where new employees need to get up to speed quickly. In these use cases, an article is valuable not for its literary quality but because it answers a question without further searching and shows who is responsible for the next step.
- Sales: lead qualification, offer boundaries, common questions, and preparation of information before handing work over to a project.
- Support: safe initial checks, signs of an urgent issue, response wording, and the point at which a specialist should take over.
- Projects: project kickoff, approval of materials, change rules, acceptance, and archiving deliverables.
- Operations: repeatable actions, internal contacts, checkpoints, and procedures for updating instructions.
Do not start by moving every old document. Older texts often contradict one another, have no owner, and contain information that should not become widely available. Start with one process that generates many repeat questions. Define its boundaries, create one concise reference article, give it to several team members, and collect feedback. You can then build out a section instead of accumulating new pages without a clear structure.
Who it suits and when another approach may be better
The module is a good fit for an owner of an already active Perfex CRM installation, a department manager, or an administrator prepared to maintain publishing discipline. It can also help a small team when instructions need to live alongside tasks and client work. A technical specialist should be involved at the beginning to review backups, CRM version compatibility, and the update process, but they do not need to become the author of every article.
The solution may be a poor fit if the company needs a public multilingual help portal with deep search across a large document collection, separate editorial approval workflows, external accounts, and sophisticated reading analytics. It would be inaccurate to promise that PerfexWiki automatically meets those needs: the product page confirms an internal knowledge base, publishing, an article map, navigation, and bookmarks, but does not provide enough evidence to attribute enterprise search, document versioning, legally binding approvals, or detailed analytics to the module.
Practical rule: before creating a section, state its promise in one sentence. For example: "This is where employees can find the approved procedure for responding to a new inquiry." If the promise cannot be verified, the section will almost certainly become a storage area for miscellaneous notes.
What makes an article easy to follow
A knowledge-base publication should work as a guided path, not as a long email. Readers should first understand whether their situation applies, then complete actions in the correct order, verify the outcome, and know where to go when an exception occurs. A useful basic format includes a brief objective, conditions, sequence of actions, expected outcome, exceptions, and an owner. A procedure may require a strict order, while a client response may need a set of verifiable facts and approved wording.
PerfexWiki lists automatic navigation and an article map among its features. Long content should therefore be divided into meaningful headings in advance instead of relying on readers to scroll until they find the right section. A heading should state an action or decision: "Verify Client Access," "Hand Off the Task to Production," or "Return the Article for Revision." A heading such as "Miscellaneous" helps neither the navigation nor a person opening the page in a hurry.
Minimum knowledge record
Before drafting the text, prepare a short author brief. In the "objective" field, state the outcome the reader should achieve. In "required inputs," list what the person completing the task needs to have available. In the action section, include only steps that can be performed in the installed Perfex CRM. Then add a verification point: what exactly should appear in the CRM, in the client message, or in the project. Finally, identify the symptom that means the standard procedure must stop and be handed over to the responsible person.
This discipline protects against two extremes. The first is an article full of general advice that still leaves employees asking colleagues what to do. The second is a technical instruction packed with internal detail and available to an audience that is too broad. Decide in advance who needs each item: employees only, a narrow group of editors, or visitors to the client area as well. This decision must be checked separately from the quality of the text.
Access boundaries: internal content, publication, and employee permissions
The most important knowledge-base setting is organizational rather than decorative. Before creating the first section, decide which information stays within the team, which information may be shown to clients, and which information should not be placed in the knowledge base at all. Internal procedures covering margins, passwords, personal data, the contract terms of a specific client, and internal keys do not become safer simply because they are placed in a convenient article. The knowledge base should contain instructions, while secrets should remain in specialized secure systems.
The standard Perfex CRM knowledge base distinguishes between internal articles and content for the client area. Official documentation describes the Internal Article setting: it is intended for employees signed in to the administrative area who have permission to view the knowledge base. An article also has a Disabled toggle that can temporarily hide it. These basic mechanisms should be treated as the lowest level of control. PerfexWiki expands the way internal knowledge can be managed and advertises a public option, so before enabling any publication, it is wise to recheck the viewing path using a regular account rather than only an administrator account.
Design the audience before the navigation
Create a simple matrix with three areas. The first contains working materials for all regular team members: procedures for handling inquiries, an answer library, and task handoff rules. The second contains materials for a restricted group: instructions for managers, editors, or the technical team. The third contains client-facing explanations: what to prepare before starting, how to submit materials, how to report an issue, and how to accept the final deliverable. Every future article should have one clear answer to the question, "Who is the reader?" If an author is unsure whether an item belongs in the internal or public area, keep it internal until it receives separate approval.
This approach is more practical than trying to fix the consequences after publication. The employee editing a text rarely sees the entire permission model. An administrator, by contrast, may not notice that a new instruction still contains a test-environment address or part of a client conversation. Two short steps before publication help: the author identifies the intended audience, and the person responsible for the section opens the material as a reader from that audience. Testing with a non-administrator account cannot be replaced by viewing the article in the administrator's own session.
| Area | What belongs there | What to check before publishing |
|---|---|---|
| Internal | Procedures, staff instructions, and escalation workflows. | View permission for the appropriate employees and no information that is not intended for all employees. |
| Restricted | Editor rules, internal quality criteria, and technical notes. | Group membership, the content owner, the reason for the restriction, and a backup contact method. |
| Public | Neutral client instructions, procedures for preparing materials, and answers to common questions. | No internal information, the link or path opens without an administrator session, and the text is clear to an external reader. |
The table is not an interface setting. It is an editorial rule that the team agrees on before working with the module. It reduces the risk of treating a public feature as unconditional permission to publish any document. Also consider the CRM's own settings: official documentation states that when the knowledge base is enabled in the client area, visitors can read the articles available there. The state of the client area should therefore be reviewed together with the content, not after a large batch of materials has been uploaded.
How to apply Perfex CRM permissions without false assumptions
In Perfex CRM, employee permissions are assigned through roles and individual permissions. For the standard knowledge base, official documentation lists View (Global), Create, Edit, and Delete. Viewing permission is tied to access to internal articles, while the ability to create, edit, and delete should not be granted to every reader simply for convenience. CRM roles have another important characteristic: assigning a role populates permissions, but an employee's individual permissions can override them. After a role is changed, existing employee profiles may not automatically receive the new model unless the option to update permissions for related staff members is selected.
At minimum, a knowledge base benefits from three working roles. A reader receives view-only access and cannot alter verified instructions. An author may create drafts and revise their own materials within an agreed process, if that level of access is actually available in the installed version and configuration. An editor or manager is responsible for review, structure, and publication. The administrator retains responsibility for module configuration, updates, and final permission management. If your version of PerfexWiki displays its own permission capabilities, first use the names shown in the interface and apply the same principle of least privilege to them.
Test the matrix with three accounts
- On a CRM copy, create one short internal item, one restricted draft, and one item approved for external viewing.
- Sign in with a reader account and verify that it can open the intended section but cannot see editing controls or the draft material.
- Sign in with an author account and confirm that it sees only the intended creation or editing functions rather than the entire administrative environment.
- Open the approved external page in a separate window without administrator authentication and check the heading, content, article map, and absence of internal fragments.
- After testing, disable the test entries or clearly label them as training content so they do not become part of the live knowledge base.
If the result of any step differs from expectations, do not try to compensate with a warning inside the article text. First return to permissions, the internal-content setting, and publication status. A sentence such as "Do not forward this document" is not a technical access restriction. For disputed content, it is better to create a neutral public version with general actions and keep internal details in the internal document.
Public publication requires separate editing
A client does not know the team's internal abbreviations, status names, or role assignments. A public text therefore cannot be created by simply removing a few paragraphs from an internal instruction. The external version answers a different question: what the person should prepare, what action to take, what outcome to expect, and where to report a problem. Internal approval timelines, employee contacts, examples from other projects, and internal checks should be removed.
A useful practice is to maintain one topic map but two independent texts. The internal article explains how a team member should handle a request. The public article explains how a client should formulate the request properly and which information to include. They may refer to the same process, but they do not need to match in detail. This reduces the risk of accidental disclosure and prevents clients from having to read a procedure written for the team.
Key takeaway: access is not configured by a folder name or by the author's good intentions. First define the audience, then assign permissions and publication status, and finally verify the outcome in an independent session.
Preparing Perfex CRM and installing the module safely
Installing PerfexWiki starts not with uploading an archive but with reviewing the environment. The CodeCanyon listing identifies the module as an extension for CodeIgniter-based Perfex CRM, not as a standalone product. The same page includes a changelog whose latest visible entry refers to fixes and compatibility optimization for a newer CRM version. This means one simple thing: compatibility should not be assumed to last indefinitely. Before proceeding, record the current Perfex CRM version, the list of third-party modules, the administrative theme, any overrides in use, and the date of the most recent backup.
Official Perfex CRM server requirements include a current PHP version, MySQL, and a set of PHP extensions, including MySQLi, PDO, cURL, OpenSSL, MBString, iconv, IMAP, GD, and Zip. However, meeting server requirements does not prove compatibility with a specific module. It only confirms that the base CRM has an appropriate environment. If the installed CRM is substantially newer than the information on the module page, the prudent approach is to deploy a test copy first and verify the actual PerfexWiki operations: activation, opening the section, creating an article, saving it, viewing it as a regular employee, and, if needed, viewing it externally.
Checklist before unpacking
Do not skip preparation simply because the module is small. An issue involving access to internal knowledge affects an entire working team, not just one page. A short inventory makes rollback possible without guesswork: you know the original versions, the original navigation state, and the names of extensions already installed. If the company has a change-management process, add a test owner and a time when the change will not disrupt employees.
- Backup: prepare a verifiable copy of the Perfex CRM files and database, not merely a note that backups were enabled at some point.
- Test environment: whenever possible, use a copy with anonymized data, separate access, and the same web-server configuration.
- Compatibility: compare the CRM version, PHP version, and list of active modules with the vendor's information; do not treat an uncertain case as confirmed.
- Rollback path: decide in advance who will disable the module and restore the copy if a menu item disappears or an error appears after activation.
- File permissions: make sure the administrator has a normal, secure way to deploy the module in the CRM directory without granting excessive permissions across the entire installation.
Do not put a live CRM into development mode just to make installation more familiar. Development mode can display technical messages that users should never see. If troubleshooting temporarily requires it on an isolated copy, restore the normal operating mode after testing. Official Perfex CRM documentation also advises returning the environment to production after investigating an error. In a public or employee-accessible system, diagnostic details can expose file paths and other internal information.
General module connection procedure
Archive formats and exact installation steps can differ among Perfex module vendors, so it would be misleading to present a universal workflow as a documented PerfexWiki instruction. The platform's basic model is as follows: a module is placed in the modules directory at the root of the installed Perfex CRM, and the administrative area shows available modules under Setup - Modules. Official developer documentation explains that a module folder and its initialization file must use matching names. For an administrator, this is useful for diagnosis: if a module does not appear in the list at all, the issue usually occurs before content configuration, in the file structure, unpacking process, or extension requirements.
- Work on a test copy and save the original list of modules and settings.
- Review the instruction file included in the vendor's official archive, and do not replace it with assumptions based on instructions for another extension.
- Place files only in the intended module directory of the installed CRM. Do not replace Perfex CRM core files or mix the contents of different archives.
- Open
Setup - Modules, locate the module entry, and activate it only after you understand how to disable the change on the same test copy. - After activation, refresh the administrative page normally, open the new menu item, and verify a basic operation before importing old documents.
The platform documentation describes module activation and deactivation mechanisms. That is why manually deleting an extension folder should not be the first response to a problem. First use the intended deactivation method, then review the error message and logs on an isolated copy. Physically removing files before a normal deactivation may leave the system in an inconsistent state, especially if the extension creates its own tables or settings.
What not to do during the first activation
Do not bulk-upload an archive of old instructions into a new module. Do not grant every employee editing rights "to avoid getting in the way." Do not move live data to a test server without anonymizing it. Do not modify the module source code for one design requirement or add unverified PHP snippets from unrelated themes. Perfex CRM has its own model for modules, options, and permissions; accessible materials do not confirm specific public PerfexWiki extension points for custom changes, so it is safer to rely on settings and editorial discipline.
Initial checks after activation
The first test should be small and reversible. Create a training article such as "Knowledge Base Test," add several meaningful headings and one neutral paragraph. Save it, close the editor, and open the page again. If your installation displays an article map, verify that it is built from the headings and leads to the correct sections. If full-screen editing is available, make sure it helps with long text rather than unexpectedly changing the document state. If bookmarks are enabled, test them with a secondary account rather than only as an administrator.
Then test three modes: administrator, a regular employee with viewing permission, and a user without that permission. As an administrator, it is enough to confirm that the module opens. As an employee, it is more important to see the expected article and no unnecessary management controls. For a user without permission, it is important to receive a denial or not see the section at all, rather than gain accidental access. Record the outcome in the team's change log: date, test environment, responsible person, actions, and outcome. This record will be useful when the module or CRM is updated.
Outcome check: installation is complete not when the activation button has been clicked, but when a training article can be saved, opened by an authorized role, and remains invisible to an unauthorized role. If any of these three conditions is not met, it is too early to begin filling the knowledge base at scale.
Knowledge navigation: headings, article maps, menus, and bookmarks
After technical activation, the main risk changes. The knowledge base may now work but still be difficult to use. PerfexWiki advertises an article map and automatic navigation, while its changelog mentions the addition of full-screen editing and a mind-map content type. Use these features not as decoration but as a way to shorten the path to an answer. In a substantial instruction, readers should understand the structure before reading the details: where the process starts, where exceptions appear, where verification happens, and who owns the process.
Start with a consistent heading convention. The first-level heading within an article identifies the process or topic, while subsequent levels explain a stage, condition, or specific case. Do not use headings merely to change text size. If the paragraph that follows does not answer the question raised by the heading, readers cannot rely on either the map or the navigation. For a lead-handling instruction, a useful structure might be: "Objective," "Required Inputs," "Main Procedure," "Exceptions," "Verification," and "Who to Escalate the Issue To." This makes the text both easy to scan and ready for automatic navigation.
How to build a hierarchy that still works next month
Instead of creating dozens of disconnected topics, establish a few stable categories. For an agency, these might include sales, project launch, production, support, and internal operations. For a service company, they might include inquiry handling, service delivery, quality, client communication, and administration. Within each category, publish an overview page first, including boundaries, the responsible person, and links to the closest instructions. Then add specific actions. This order lets employees begin with the general rule rather than guessing between similar titles.
The standard Perfex CRM knowledge base supports article groups, and PerfexWiki advertises automatic navigation. Exact element names and placement may differ in a particular installation, so first create two or three test entries and see how the module reflects the hierarchy. Do not create a large number of empty sections "for later." An empty section feels like a promise that an answer exists there and reduces trust in the knowledge base. It is better to complete one section than to simulate a large structure.
- Overview page: the purpose of the category, a list of processes, the owner, and the next review date.
- Working instruction: actions in execution order, required inputs, verification, and exceptions.
- Reference article: terms, service boundaries, approved answers, and internal company sources.
- Case review: the symptom, cause, actions taken, and the rule changed after the case.
Each item benefits from a brief indication of whether it is current, but do not turn that into a false appearance of control. If the team lacks the capacity to review every page weekly, choose a realistic cycle: for example, review after a process change, a change of ownership, or a recurring error. Do not promise a complete version history unless your installation's interface confirms it. Instead, identify an owner and agree that any process update includes a review of related pages.
When to use an article map and a mind map
An article map works well for long linear content: users can see a table of contents, move quickly to a stage, and return to the beginning. It is suitable for a launch procedure, an instruction for handling an inquiry, or a description of a complex service. Its quality is determined not by the number of entries but by the clarity of the headings. If every entry is called "Settings" or "Additional Information," the map does not help.
The mind-map content type mentioned in PerfexWiki updates serves a different purpose. It is appropriate when dependencies need to be shown: for example, what information the account manager receives, what is handed to the project, who approves a change, and when the client receives an answer. Do not try to force the full text of a procedure into a map. The central node states the objective, with required inputs, roles, actions, and checkpoints arranged around it. Keep a brief explanation for each node in a regular article, or the diagram will become unreadable.
Two-minute navigation check
Open a completed article on a regular laptop, not in editing mode. Try to answer three questions without reading the text from start to finish: where is preparation, where is the exception, and where is final verification? Then follow the article-map entries, if they are displayed, and confirm that each jump leads to the exact section rather than a neighboring paragraph. If the author spends more than two minutes searching, a new employee will spend even longer. Rename headings and reduce nesting before publication.
Then send the link to one employee who did not participate in writing it. Do not ask them to evaluate the style. Ask them to complete one small task, such as identifying the minimum information required to hand off a project. If the person opens the wrong section or asks a question that is supposedly "already in the article," that is not their mistake. It indicates that the structure or wording needs improvement.
Configuring content after installation: from draft to verifiable instruction
The most useful PerfexWiki configuration happens inside the content itself. Even sound access controls and a tidy menu cannot save a text that mixes rules, author comments, and exceptions. Immediately after activation, agree on publication states. For example, a new item may begin as a draft, then be read by the process owner, after which an editor reviews the structure and permissions, and publication is confirmed by an assigned person. This is not a claim about a built-in module editorial workflow; it is a safe organizational model that can be used even when special statuses are unavailable.
The vendor advertises full-screen article editing. Use it for lengthy procedures where you need to review the structure and headings as a whole. However, do not enter information in full-screen mode that should never remain in the company record: access secrets, card numbers, personal documents, or complete conversation exports. Editor convenience does not change data policy. Prepare a safe anonymized example first, then add a link to a restricted internal source if company rules allow it.
A template that can be copied without losing meaning
For recurring instructions, create one training template within the knowledge base. It does not need to be a separate module feature: it can be an ordinary article that authors use as a model. Include these sections: "When to Use This," "Required Inputs," "Actions," "Verification," "Exceptions," and "Owner of Current Information." Do not fill the template with meaningless phrases. Each section should tell the author what specific information they are required to provide. When a new instruction is created, the prompts are replaced with verifiable content.
It is useful to distinguish between a rule and an example. A rule states that a particular action is required. An example shows what that looks like in one safe case. If an example no longer matches the current process, it can be removed without damaging the instruction. If an example is presented as a rule, the team will begin copying a special case. Separate them clearly with a heading or a short introduction: "Agency Example" or "Specific Case."
Pre-publication review
- Check that the heading answers the reader's question rather than repeating the name of an internal folder.
- Make sure the actions can be completed in the current process and do not refer to retired tools or former employees.
- Review every access condition: internal or external audience, reading permissions, and disabled or active status.
- Open the material in reading mode and follow the article map if it is enabled in your installation.
- Assign an owner and an event that requires review: a service change, CRM update, new error, or process change.
Do not try to automate review with questionable code in the module files. Public sources do not confirm specific PerfexWiki hooks, classes, or APIs for modifying the editor or permissions. Editing the CRM core or third-party module files will complicate updates and make rollback more costly. At the beginning, a managed procedure, permission matrix, and test through a separate account are sufficient.
Key takeaway: useful navigation comes from meaningful headings, a limited number of categories, validation of the reader's path, and publication discipline. An article map shows the route, but it cannot replace clear text and author accountability.
Practical use case: a knowledge base for handing a website project from sales to production
Consider a concrete use case that clearly demonstrates PerfexWiki's purpose. An agency receives a lead, the account manager agrees on the website scope, and then hands information to the designer, developer, and project manager. Problems usually arise not because the team does not know how to work, but because required details about the page goal, materials, access, approvals, and work boundaries remain scattered across different messages. As a result, the project starts with incomplete information, and the client receives another list of questions a few days later.
The goal is to create one verifiable internal CRM instruction called "Website Handoff to Production." It should help the account manager collect information before the handoff, help the delivery team understand the task's status, and help a manager quickly see why the launch has stopped. The material remains internal: it may include the team's working roles and agreements, but it must not contain passwords, payment information, or complete client correspondence. A separate neutral article about preparing materials can later be created for the client if needed.
Prepare the use case and assign a process owner
Before creating the article, assign an owner. For a website handoff, this is usually the head of project delivery or an operations manager, not one of the content authors. This person confirms which fields are mandatory, who may stop the handoff, and where the outcome is recorded. Agree on terminology: "materials received" means the files are ready for use, not that the client promised to send them. "Scope approved" means a specific document or CRM record, not an account manager's verbal impression. The more precise these definitions are, the fewer conflicts will arise after the instruction is published.
Prepare a minimum set of required inputs. Do not turn it into a questionnaire with dozens of fields. To launch a website project, you generally need a client contact and responsible person, the project goal, agreed scope, page structure or page list, materials and usage rights, technical access through an approved secure channel, an assigned project manager, and the nearest checkpoint date. If even one critical item is missing, the instruction should clearly state that the handoff is paused rather than sent to production "as is."
Build the article as a sequence of decisions
In PerfexWiki, create an internal article with a clear title, such as "Website Handoff to Production: Pre-Launch Review." Place it in a section employees would naturally look for while handling a deal, rather than in a general "Documents" area. The first paragraph should state the outcome: after following the instruction, the project has a complete launch package or a recorded list of missing information. Then use headings that support the article map: "When to Start the Review," "Information from the Account Manager," "Reviewing Materials," "Handing Off to the Project," "What to Do with an Incomplete Package," and "Final Confirmation."
- Define the trigger. State when the account manager opens the article: after the work has been agreed but before a production task is created or handed to the delivery team.
- Describe the required inputs. List only verifiable information and specify where it must be located in the CRM or approved storage.
- Split the review into blocks. Review commercial agreements, content, technical prerequisites, and assignment of responsible people separately.
- Add a stop condition. Specify which missing information prevents work from starting and to whom the issue must be returned.
- Record the output. Describe which record or task must appear after a successful handoff and who receives a notification.
In this use case, the article map helps employees follow the path from top to bottom, while a bookmark is useful for someone who returns to the same procedure several times a day. If your PerfexWiki installation offers a mind-map article type, create a small dependency diagram for the main instruction: a central node labeled "Ready for Production," with branches for "Scope," "Content," "Access," "Roles," and "Next Step." Do not duplicate the full text in the map. Its purpose is to show which block is missing in ten seconds.
Review materials without publishing sensitive information
A common mistake is to insert real data from the first convenient project into an instruction: account addresses, internal links, test credentials, or excerpts from correspondence. This turns a useful template into a source of risk. In the article, describe the type of material and where it is stored, but do not record the actual value. For example: "Access has been confirmed in the approved secrets manager" or "Source files are attached to the project record under the internal policy." If an employee needs specific access, they receive it through the established process, not from a knowledge-base article.
Content review should also be specific. The employee checks whether there is a page list, copy or a person responsible for it, images with a clear source, the correct logo variation, and a contact for approvals. Do not require "all materials" without explaining what that means, because everyone will interpret it differently. Where a project may proceed with an incomplete package, the instruction should distinguish acceptable gaps from blocking gaps. For example, a draft page structure may be enough for an estimate, but the absence of an approved scope does not allow a production deadline to be scheduled.
Final confirmation and outcome check
After completing the instruction, the account manager makes one clear confirmation in the CRM's accepted working process: creates a task, changes an agreed status, or leaves a standardized note. The exact field depends on your Perfex CRM configuration, so it would be wrong to invent a PerfexWiki interface item. What matters is that the next team member sees not a message saying "everything is ready," but a verifiable record showing who handed over the package, when it was done, what was checked, and which item needs attention.
For validation, ask someone who did not participate in creating the article to perform the handoff on a training project. They should open only the instruction and the test task record. Measure not reading speed but the number of clarification questions: where to find materials, whether work can start without access, to whom an incomplete package should be returned, and how readiness should be recorded. If questions repeat, add the answer to the relevant section rather than appending it to the end of the article "just in case." After two or three real walkthroughs, important exceptions that the author did not remember usually become clear.
How to separate an internal procedure from client instructions
A client may benefit from a separate short publication called "How to Prepare Materials for a Website Launch." It should retain the list of needed files, submission rules, and a contact method for reporting readiness. Internal roles, estimation conditions, negotiation history, and the team's technical decisions should be removed. If the module and CRM settings allow content to be published outside the internal area, test this page in a clean session and on a neutral device. If there is any doubt, keep the material internal until it receives separate approval.
This is a useful combination with the standard Perfex CRM knowledge base: the base model distinguishes internal articles from the client area, while PerfexWiki helps organize internal content and navigation more conveniently. There is no need to call this an official integration between separate products; it is a practical way to use capabilities within one CRM. The safe order is: first create the internal instruction and test roles, then create an independent adapted publication for the client, and finally test access without administrator authentication. If the external text turns out to be too broad, disable it using the available status, revise the content, and repeat the test.
Outcome check: the use case is working when a new account manager can complete a training handoff and the delivery team receives a full launch package without contacting the instruction author. If the process depends on verbal explanation, the knowledge base has not yet accomplished its purpose.
How to confirm that an article is useful, not merely published
The Save button only confirms that text exists. For a knowledge base, it is more important to show that it changes a working action. For each key procedure, choose one observable outcome: fewer repeated questions, fewer incomplete requests returned for correction, a new employee completing a step without a mentor, or an inquiry receiving an accurate initial response faster. You do not need to build complex analytics if the team is not ready for it. It is enough to regularly record a few cases before and after the instruction appears.
Start with a short observation log. For the "Website Handoff" instruction, record the date, project type, whether the package was accepted on the first attempt, which item was unclear, and what revision was made. After a few weeks, it becomes clear what the instruction actually improves. Sometimes the problem is not the text but the process itself: for example, there may be no owner for materials, or different account managers may use different readiness criteria. In that case, the article should honestly reflect the team's decision rather than hide an organizational gap behind a polished checklist.
Three levels of post-publication validation
The first level is technical. The article opens, headings appear in the expected hierarchy, the article map or menu does not lead nowhere, and saved content is not distorted. The second level is access. A reader with the correct role sees the material, an editor can perform only the intended actions, and a user outside the audience does not receive extra access. The third level is operational. An employee completes the task using the instruction and leaves the expected record in the CRM or accepted process. All three levels matter: a well-designed page with incorrect permissions is just as useless as correct permissions with no clear action.
Assign an owner for each level. The administrator checks access and module status, the editor checks structure and clarity, and the process owner checks that the instruction reflects actual work. One role may handle these responsibilities in a small team, but the checks themselves should not disappear. When the author is the only reviewer, they are likely to overlook their own abbreviations and assumptions.
The "new employee" test
The most honest way to test usefulness is to ask someone with minimal context to complete a narrow task. They should not receive verbal hints, otherwise you are testing the mentor rather than the article. Give them a training case, access to the permitted section, and one question. Then observe where they begin, where they stop, what they misunderstand, and which terms are unexplained. Do not correct every reader; correct the instruction itself. If two people interpret a sentence differently, it is ambiguous for future employees as well.
After the test, add a short "When to Use This" block at the beginning of the article and a "When to Stop" block at the end. These two boundaries are often more useful than ten additional technical details. The first prevents the instruction from being used in an unsuitable case, while the second protects against automatically completing an action that requires a manager's decision. For a knowledge base connected to client work, this predictability matters more than text length.
Keeping content current, managing updates, and making safe improvements
A knowledge base becomes outdated for more reasons than typos. A service changes, an inquiry-handling path changes, the team changes, the CRM version changes, or an external tool changes. Every important article should therefore have an owner and a review trigger. There is no need to put a date in the heading if it will quickly lose meaning. It is better to state in the content which change should prompt a review: "Review after the intake form changes" or "Update when the project handoff procedure changes." This connects the text to a real reason rather than a calendar ritual.
The PerfexWiki changelog visible on the product page shows fixes and changes related to article display, full-screen editing, maps, and the public option. These items are important enough to justify repeating navigation, permissions, and viewing tests before updating the module. Do not assume that "the update is small." In a modular environment, changes to templates, navigation, or permissions may appear only under a restricted role. Create a backup first, apply the update in a test environment, and then repeat the short three-role use case.
An update procedure without risky customization
Before updating, create a list of critical checks instead of trying to remember them after an error occurs. For PerfexWiki, this includes opening the section, creating and saving a test article, displaying the structure of a long article, the behavior of the advertised map and bookmarks, employee access, lack of access for an unnecessary role, and viewing published external content if you use it. Compare the outcome with documented pre-update behavior, not with a general impression that "everything looks about the same."
- Create a verifiable backup and record the list of active modules.
- Repeat the update on an isolated copy with the same roles and basic configuration.
- Open one existing long article and one new training item, then check saving and navigation.
- Test access as a reader, author, and user without viewing permission.
- Only after a successful test, approve a change window for the live CRM and retain the rollback path.
Do not directly modify module files to rearrange navigation, add an unverified button, or hide part of the interface. Any such modification complicates updating and may be lost when files are replaced. If new behavior is required, first look for a built-in setting and confirmation from the vendor. If no such confirmation exists, document the request as a product need and keep any workaround outside the CRM core and outside third-party module files. Accessible sources do not provide public documentation confirming a specific PerfexWiki filter or hook for safe code, so a ready-made PHP snippet here would be invented.
Safe editorial improvements without code
Instead of technical intervention, improve the reading experience through consistent rules. Agree that every instruction begins with one sentence stating the outcome, that a critical action is highlighted in bold, and that an exception is accompanied by a short warning block. Allow no more than one primary action per step. If an operation is performed in the CRM, name the exact section or save an interface screenshot in the team's internal documentation, but do not promise button names you have not verified in your version.
Use a map or mind-map article separately for processes with a branch. For example, in support, an incoming question may split into "can be resolved using the instruction," "needs clarification from the client," and "requires technical escalation." Regular text preserves wording and conditions, while the map helps users quickly choose a branch. After changing a rule, review both representations. If the text changes but the map still points to the old action, the knowledge base creates a dangerous illusion of accuracy.
How to use bookmarks
The advertised bookmark feature is useful for an employee's personal path: a frequently used procedure can be opened quickly without remembering its exact place in the overall hierarchy. However, a bookmark should not become the only way to find an article. A new employee will not have it, while an experienced employee may retain an outdated link. First provide clear categories and headings, then offer bookmarks as an accelerator. When reviewing important content, ask the team to open it through the navigation and make sure the old path is not misleading.
How to connect PerfexWiki with the standard knowledge base and CRM workflows
Perfex CRM already includes its own knowledge-base model, groups, internal content, and client area. PerfexWiki is best introduced as a more convenient environment for working with internal knowledge, not as a reason to maintain two independent encyclopedias containing the same answers. Before adding content, decide where the source of truth for each topic will live. For example, a general client answer may remain in the standard public knowledge base, while an internal team instruction may live in PerfexWiki. Or, if you select one module as the primary environment, record which older sections should no longer be edited.
This does not imply automatic synchronization or a confirmed two-way integration; such features should not be attributed to the product without documentation. This is an editorial agreement: one process owner ensures that the public explanation and internal instruction do not contradict one another. When a service changes, that person updates both versions or archives the outdated one. The change record identifies which page needs review. This simple bridge prevents a situation in which a client reads an old promise while an employee already follows a new rule.
Key takeaway: a publication is useful when three things can be demonstrated: the text opens technically, the correct audience can see it, and an employee can complete the action without additional interpretation. A module update should recheck the same three things.
Troubleshooting: when an article does not open, is not visible, or does not help
Knowledge-base issues are easier to investigate by moving from the symptom to a verifiable cause. Do not begin by reinstalling the module, and do not delete files from the live server until you know at which point the failure occurs. In Perfex CRM, access, publication, and module structure exist on different layers. The same symptom, "I cannot see the article," may mean missing permission, internal article status, a disabled client knowledge base, incorrectly placed module files, or simply confusing navigation.
The module does not appear in Setup - Modules
Symptom: after placing the archive in the CRM, no PerfexWiki entry appears among the modules. Possible cause: an incorrect directory structure, incomplete unpacking, a mismatch between the folder and initialization-file names, a server error, or incompatibility with the current CRM. What to check: on a test copy, compare the structure with the official instruction included in the received archive and with general Perfex CRM module rules. The platform expects modules in the modules directory; an incorrect folder nesting level often prevents the system from discovering an extension.
Fix: restore the original test copy, place the files again according to the vendor's instructions, and review system messages in an isolated environment. Do not grant write permissions across the entire server or rename files at random. When to roll back: if an administrator error appears after correct placement or another extension is affected, disable the change through the intended method and restore the saved copy before contacting vendor support.
An employee cannot see internal content
Symptom: an administrator can open the article, but an employee sees an empty section, receives a denial, or cannot see the knowledge-base menu item. Possible cause: the employee lacks permission to view the knowledge base, a role was changed without updating individual permissions, the material was created as internal and is correctly hidden from an unauthenticated user, or the module uses a separate access setting. What to check: open the employee profile and actual permissions rather than relying only on the role name. Official Perfex CRM documentation states that internal standard knowledge-base articles require View (Global) for the knowledge base.
Fix: grant the minimum required access to a test account, save the change, and sign in to the CRM again. If the material should be available to an external reader, do not change permissions blindly: separately check the internal and external publication states according to your installation's rules. When to roll back: immediately revoke a broad permission if, after the change, the employee sees not only the intended article but also other restricted sections.
Content is accidentally available to the wrong audience
Symptom: an internal procedure opens in the client area, or a link works outside the expected account. Possible cause: publication and audience were not checked separately, the material has a neutral title and was mistakenly placed in the public area, or knowledge-base display is enabled in the client area. What to check: open the path in a new private window without authentication, then using a separate test role. Read not only the text but also the heading, embedded examples, maps, and related materials.
Fix: immediately disable or restrict publication using the available status, remove internal fragments, create a separate external edition, and retest. When to roll back: if you cannot confidently prove the visibility boundary, keep the material internal until the CRM configuration and module installation have been reviewed.
The article map and menu do not help users find an answer
Symptom: the article opens, but employees still ask where to find the required step; navigation links lead to similar sections. Possible cause: headings are too general, heading levels are inconsistent, the text was inserted as one large unstructured block, or several processes are mixed within the article. What to check: try to find the preparation block, exception, and verification using headings only. Then ask a new employee to complete one training case without verbal prompts.
Fix: rename headings as actions, move exceptions into a separate section, and split overloaded content into an overview and working instructions. When to roll back: no technical rollback is needed because this is an editorial issue. However, do not publish a new map or mind map until it is aligned with the main text.
Expected behavior disappeared after an update
Symptom: after updating the CRM or PerfexWiki, navigation, the editor, permissions, or article visibility changed. Possible cause: the module environment changed, the update was not tested on a copy, a manual modification existed previously, or a new CRM version affected the interface. What to check: compare the outcome with the pre-update test log: opening an article, saving, the reader role, the editor role, and external viewing.
Fix: in the test environment, disable the latest change through the normal method or restore the point before the update, then collect an exact description of the symptom for support. When to roll back: if the access boundary is broken or employees cannot open a critical procedure, rollback takes priority over cosmetic interface adjustments.
Questions that arise before launching a knowledge base
Can CodeCanyon PerfexWiki be considered a WordPress plugin?
No. The product page identifies it as a module for Perfex CRM that runs in a CodeIgniter environment. A page category or path does not change its technical purpose. Install and test the module in Perfex CRM rather than looking for it among WordPress extensions.
Do I need PerfexWiki if the CRM already includes a knowledge base?
Not necessarily. The built-in knowledge base is suitable for simple groups, articles, internal access, and the client area. PerfexWiki is worth evaluating if your team needs the internal navigation and knowledge-presentation methods it advertises. First make a list of real difficulties and test them with a training article instead of moving the entire knowledge base solely for a new interface.
Can all content remain internal and some items be opened to clients later?
Yes, this is a safe working order if the particular installation and CRM settings provide the required publication mode. First refine content and permissions for an internal audience, then create an independent external edition and test it without an administrator session. Do not publish internal text simply by switching a status without editorial review.
Why can an employee with a role not see an article?
Check the employee's actual individual permissions, the article's internal status, and whether the role changes were applied to the correct employee profile. In Perfex CRM, roles can populate permissions, but individual employee permissions also matter. Test using the specific account after signing in to the CRM again.
Does the module support a complete version history and document approval workflow?
Those capabilities are not confirmed in the accessible product listing. Do not present an organizational draft-and-review procedure as a built-in versioning system. If legally significant approval or a detailed revision history is required, first obtain direct confirmation from the vendor or choose a specialized system.
How often should articles be reviewed?
Not according to a calendar just for reporting purposes, but after a process, service, access permission, integration, CRM update, or module update changes. Every critical article should have an owner and a clear review trigger. After an update, always repeat checks for saving, access, and reading under different roles.
Can access credentials and other secrets be stored in an article?
No. An instruction should explain where an employee receives access through the approved process, but it must not include the secret values themselves. Separate useful procedural knowledge from sensitive data, which should be stored in the company's secure system.
When CodeCanyon PerfexWiki is a good choice
CodeCanyon PerfexWiki can be a good choice for a team already working in Perfex CRM that wants to make internal procedures, instructions, and repeatable answers available alongside day-to-day work. Its strength is revealed not by bulk-moving old files, but by carefully launching one important process: a clear structure, limited access, a short outcome check, and an assigned owner responsible for keeping it current.
Start with a test copy, one training article, and three viewing roles. If the path is clear to a new employee, access stays within the intended audience, and the real process leaves a verifiable record, you can gradually fill out the sections. When preparation is complete, go to the section to download the ZIP archive, then repeat the same safe test on your own Perfex CRM installation first.


