Hướng dẫn cài đặt và sử dụng PolyUtilities cho Perfex CRM

Cảm ơn bạn đã lựa chọn mô-đun PolyUtilities cho Perfex CRM. Nếu bạn có bất kỳ câu hỏi nào ngoài phạm vi của tệp tài liệu hướng dẫn này, vui lòng gửi email cho chúng tôi qua biểu mẫu liên hệ tại đây.

...

Trang Demo các tính năng của PolyUtilities:

Địa chỉ trang: https://polyutilities.polyxgo.com/admin

Do đặc thù tùy chỉnh mã nguồn JavaScript và CSS phụ thuộc vào nhu cầu tích hợp riêng của từng khách hàng, chúng tôi không cung cấp phiên bản demo chạy thử cụ thể. Tuy nhiên, bạn có thể xem trước danh sách tính năng mà mô-đun hỗ trợ thông qua các hình ảnh tham khảo đi kèm.

Khả năng tương thích:

Mô-đun được phát triển và kiểm thử để đảm bảo tương thích 100% với mã nguồn gốc Perfex CRM và khung lập trình CodeIgniter. Khi tích hợp mã nguồn JavaScript tùy biến, vui lòng đảm bảo không xảy ra xung đột với mã nguồn Perfex CRM. Trong trường hợp xảy ra xung đột, khách hàng có thể liên hệ với chúng tôi để được hỗ trợ tích hợp, tư vấn và xử lý lỗi.

Tải lên và kích hoạt mô-đun (Module)

Các bước cài đặt chi tiết

• Giải nén nội dung tệp tin đã tải về. Bạn sẽ thấy một thư mục tên là “documentation” và một tệp ZIP mới tên là “poly_utilities.zip”.

• Tệp “poly_utilities.zip” chứa toàn bộ mã nguồn của mô-đun để tải lên hệ thống.

• Truy cập vào khu vực Admin của Perfex CRM và chọn menu sau: HỆ THỐNG (SETUP) > MODULES (MÔ-ĐUN).

• Chọn tệp poly_utilities.zip ở trên tại khung tải lên và nhấn CÀI ĐẶT (INSTALL).

• Tìm mô-đun tên là PolyUtilities và nhấp chọn Kích hoạt (Activate). Hệ thống sẽ thông báo mô-đun đã được kích hoạt thành công.

Bây giờ bạn có thể bắt đầu sử dụng mô-đun bằng cách truy cập vào menu PolyUtilities.

Video Demo hướng dẫn

Cách sử dụng mô-đun PolyUtilities

Danh sách các tính năng hỗ trợ

• Tùy biến menu (custom links for perfex crm).

• Hộp công cụ hỗ trợ All-in-one cho khách hàng.

• Tích hợp hệ thống Widgets đa vị trí.

• Hộp tìm kiếm menu nhanh trong Perfex CRM.

• Menu Sidebar dạng thu gọn chỉ hiển thị icon.

• Hỗ trợ phím tắt Ctrl+S để lưu nhanh nội dung khi soạn thảo: Hợp đồng, Dự án, Ghi chú dự án, Bài viết.

• Hỗ trợ tự động tạo Mục lục (Table of Contents) để truy cập nhanh các đề mục khi soạn thảo nội dung. Dễ dàng tạo danh sách Liên kết yêu thích (Favorite Links) trong Perfex CRM.

• Hỗ trợ nhúng mã JavaScript và CSS tùy biến riêng cho khu vực quản trị admin, khu vực khách hàng client hoặc cả hai.

• Hỗ trợ thiết lập và quản lý Menu truy cập nhanh (Quick Access Menu) và các phím tắt truy cập nhanh các tính năng hoặc đường dẫn.

Tùy biến Menu — Custom links

• Hỗ trợ tạo mới, chỉnh sửa, xóa và gom nhóm danh sách các menu ở Sidebar, Setup và Client. Quản lý phân quyền hiển thị menu và các nhóm menu tùy chỉnh theo vai trò (roles) và tài khoản nhân viên (users).

• Dễ dàng sắp xếp và tổ chức lại danh sách: menu chính, menu cài đặt và menu phía khách hàng. Hỗ trợ thêm biểu tượng icon, nhãn hiển thị và màu nền riêng biệt.

• Các liên kết menu tùy chỉnh hỗ trợ hiển thị dưới dạng iframe, liên kết trực tiếp, rất tiện lợi để tra cứu tài liệu chung, tệp Excel, hợp đồng... liên quan đến nhóm menu. Ví dụ: tạo nhóm liên kết mạng xã hội: YouTube, Facebook, TikTok, LinkedIn, Pinterest...

• Hỗ trợ ẩn hoặc hiện các mục menu ở sidebar & setup. Kết hợp tính năng tùy biến các nhóm menu khác nhau cho nhiều mô-đun trên cùng một hệ thống.

• Tích hợp đường phân cách (Type Divider) khi tạo mục menu tùy biến để ngăn cách các nhóm chức năng trên menu sidebar và setup.

• Định dạng Type Popup hỗ trợ hiển thị nội dung HTML tùy biến trên cả 3 cấp độ của Sidebar menu. Quản trị viên có thể tạo các popup thông báo hoặc tài liệu gán cho các vai trò hay tài khoản nhân viên cụ thể. Ví dụ: bảng công bố phần thưởng cho đội ngũ thuộc vai trò marketing.

Menu Sidebar

Menu Setup

Menu Khách hàng (Clients menu)

Menu ngữ cảnh chuột phải (Custom Context Menu)

Dễ dàng tạo mới, gom nhóm và quản trị danh sách các mục menu ngữ cảnh khi nhấp chuột phải trong môi trường làm việc của Perfex CRM.

Tương tự như Menu truy cập nhanh, Menu ngữ cảnh cho phép nhân sự di chuyển nhanh đến các tính năng cốt lõi được cấu hình thông qua chuột phải như hóa đơn, khách hàng, dự án, v.v.

Widgets

Đây là tính năng tích hợp các widget phổ biến giúp bạn chèn thêm các thành phần hiển thị nội dung vào Perfex CRM mà không cần kiến thức lập trình, hoạt động tương tự như Widgets trong CMS WordPress.

Tính năng cũng hỗ trợ các điểm neo hook và filter, cho phép các lập trình viên phát triển các mô-đun hiển thị dữ liệu tùy biến tại các vị trí widget được hỗ trợ.

Các widget được hỗ trợ

Hiện tại, mô-đun hỗ trợ các widget mặc định như:

• Text: hiển thị nội dung văn bản thông thường.

• Image: hiển thị hình ảnh (sắp ra mắt).

• HTML: hiển thị nội dung mã HTML tùy biến.

• Language: hiển thị bộ chuyển đổi ngôn ngữ kèm biểu tượng cờ quốc gia.

Các widget hữu ích khác sẽ được liên tục cập nhật trong các phiên bản tiếp theo. Bạn có thể đề xuất các widget hoặc dữ liệu từ mô-đun bên thứ ba để chúng tôi xem xét tích hợp.

Các khu vực hiển thị widget hỗ trợ

• After topbar menu: Trên menu chính.

• Right avatar: Phía bên phải ảnh đại diện.

• After avatar: Phía dưới ảnh đại diện.

• Before sidebar logo: Trước logo thanh bên.

• Before sidebar menu: Trước danh sách menu thanh bên.

• After sidebar menu: Sau danh sách menu thanh bên.

• Before setup menu: Trước menu cài đặt.

• After setup menu: Sau menu cài đặt.

• Before dashboard: Phía trên bảng điều khiển chính.

• Before article details: Trước nội dung chi tiết bài viết.

• Between article details: Giữa nội dung chi tiết bài viết (yêu cầu bài viết có ít nhất 4 đoạn văn dạng thẻ p).

• After article details: Sau nội dung chi tiết bài viết.

• Admin footer: Chân trang khu vực quản trị.

• Customer dashboard header: Trên cùng trang tài khoản khách hàng.

• Customer footer: Chân trang khu vực khách hàng.

• Before customer login form: Phía trên biểu mẫu đăng nhập khách hàng.

• After customer login form: Phía dưới biểu mẫu đăng nhập khách hàng.

• Before admin login form: Phía trên biểu mẫu đăng nhập admin.

• After admin login form: Phía dưới biểu mẫu đăng nhập admin.

Hooks đăng ký thêm vị trí hiển thị cho Widgets

Hàm dưới đây giúp đăng ký thêm vị trí hiển thị widget mới ngoài các vị trí mặc định phục vụ cho việc phát triển các mô-đun tùy biến riêng:

hooks()->add_action('poly_utilities_widgets_init', [$this, 'poly_utilities_hook_widgets_init']);

public function poly_utilities_hook_widgets_init($widgets){
        $new_widget = array(
            'id' => 'poly-widget-simple-hook',
            'name' => 'Simple hook main menu',
            'description' => 'Display hook.'
        );
        $widgets[] = $new_widget;
        return $widgets;
}

Hiển thị nội dung:

if (poly_utilities_widget_helper::is_active_widget('poly-widget-simple-hook')) {
     poly_utilities_widget_helper::dynamic_widget('poly-widget-simple-hook');
}

Hộp công cụ All-in-One cho Khách hàng (All-in-One Support)

Tính năng All-in-one Support giúp bạn kết nối nhanh với khách hàng thông qua các kênh liên lạc phổ biến như điện thoại, email, chat messenger, WhatsApp, Viber, liên kết tài liệu hướng dẫn và trung tâm hỗ trợ. Hỗ trợ tùy biến thông điệp chào mừng đối với nút tương tác hỗ trợ khách hàng.

• Có thể cấu hình hiển thị biểu tượng hỗ trợ cho Admin, Clients hoặc cả hai.

• Hỗ trợ cá nhân hóa: Khi đăng nhập, khách hàng có thể xem nhanh thông tin liên hệ của nhân sự trực tiếp phụ trách dự án họ đang tham gia (sẽ được tích hợp trong phiên bản sắp tới).

• Hỗ trợ kéo thả để thay đổi vị trí của biểu tượng liên hệ All-in-One trên màn hình để tránh đè lên các biểu tượng cố định khác trên trang web.

Thanh trượt Biểu ngữ/Thông báo (Banners/Announcements Sliders)

Tạo mới và quản lý danh sách các slide biểu ngữ.

• Hỗ trợ tải lên ảnh biểu ngữ, liên kết biểu ngữ, mã nhúng video iframe, iframe bài viết, mã HTML tùy chọn...

• Hiển thị slide biểu ngữ tại các vị trí widget được hỗ trợ: trang quản trị, khu vực khách hàng, giữa bài viết...

• Thiết lập lịch trình bắt đầu và kết thúc hiển thị cho từng biểu ngữ.

• Lựa chọn các hiệu ứng chuyển động phổ biến: fadeInOut, slide, flip, flipX, flipY, zoomInOut, jackInTheBox, rotateInOut.

Mở rộng tính năng Dự án (Project extensions)

Quản lý danh sách tiền tố dự án phục vụ phân loại phân nhóm dự án. Ví dụ: APP-, WEB-, MOD-, PLU-, IOS-, CRM-, v.v.

Tích hợp các nút tạo nhanh Báo giá, Đề xuất và Người liên hệ ngay trên màn hình chi tiết dự án, tự động điền các thông tin khách hàng và thông số dự án tương ứng giúp tối ưu hóa thao tác.

Hộp tìm kiếm Menu Perfex CRM

Việc di chuyển qua lại các danh mục menu khi CRM cài đặt quá nhiều mô-đun thường mất rất nhiều thời gian. Tính năng tìm kiếm menu giúp bạn nhanh chóng định vị chính xác tính năng cần dùng. Sau khi tìm kiếm, bạn cũng có thể ghim kết quả vào Menu truy cập nhanh để sử dụng cho lần sau.

Tích hợp bộ lọc cột trên bảng dữ liệu (Data Tables Filter)

Hỗ trợ tùy chọn bật/tắt hiển thị các cột trên toàn bộ các bảng dữ liệu mặc định của Perfex CRM và bảng của các mô-đun bên thứ ba. Cấu hình được lưu giữ riêng cho từng tài khoản quản trị và hỗ trợ đa ngôn ngữ.

Menu truy cập nhanh (Quick Access Menu)

Giúp nhân sự truy cập nhanh đến các tính năng thường xuyên sử dụng để tối ưu hóa hiệu suất làm việc.

Tạo liên kết truy cập nhanh mới

Truy cập PolyUtilities > Quick Menu và nhập thông tin:

• Icon: Tên class biểu tượng Font Awesome (ví dụ: fa fa-file).

• Title: Tên hiển thị của liên kết trên menu nhanh.

• Shortcut key (Hotkey): Chọn phím tắt truy cập nhanh dạng tổ hợp 1 chữ cái và 1 số.

• Link: Đường dẫn cần di chuyển đến.

• Target: _blank, _self, _parent...

• Rel: follow, nofollow, noopener...

Sắp xếp thứ tự

• Để thay đổi vị trí hiển thị, truy cập PolyUtilities > Quick Menu và kéo thả các liên kết trong danh sách đến vị trí mong muốn, sau đó lưu lại.

Sửa hoặc Xóa liên kết

• Nhấp vào biểu tượng thùng rác để xóa hoặc biểu tượng bánh răng để chỉnh sửa cấu hình.

Nhúng mã JavaScript tùy biến (JS)

Cho phép quản trị viên chèn mã JS tùy biến riêng cho khu vực Admin, Client hoặc cả hai. Tích hợp tính năng khóa mã nguồn: Quản trị viên ID 1 (Super Admin đầu tiên) có thể khóa tệp cấu hình để tránh việc các quản trị viên khác chỉnh sửa, đảm bảo mã chạy ổn định.

Truy cập PolyUtilities > JavaScript (JS) và chọn New JS file:

• Title resource: Tên mô tả chức năng của đoạn code. Ví dụ: Thêm đồng hồ hiển thị trên thanh công cụ.

• File name: Tên tệp lưu trữ (dùng chữ cái thường a-z, số 0-9 và dấu gạch ngang "-").

• Đánh dấu chọn các khu vực hoạt động tương ứng (Admin, Client hoặc cả hai) và viết code tương ứng.

Nhúng mã Style tùy biến (CSS)

Truy cập PolyUtilities > Style (CSS) và chọn New CSS file để thiết lập tương tự như chèn mã JS.

Giao diện (Appearance)

Tùy biến trang đăng nhập (Custom Login Page)

Cá nhân hóa hình nền, logo và màu sắc trang đăng nhập. Hỗ trợ thiết lập hình nền riêng cho trang login của Admin và trang login của Khách hàng, kèm theo các hiệu ứng tuyết rơi, mưa rơi, ma trận số... hoặc nhúng hiệu ứng JS tùy chọn của riêng bạn.

Tính năng Tải về Mô-đun (Download Module)

Cho phép quản trị viên xuất bản, sao lưu và tải trực tiếp các tệp zip cài đặt của từng mô-đun đang hoạt động trên hệ thống ngay từ trang quản trị để dễ dàng sao lưu hoặc di chuyển sang các hệ thống Perfex CRM khác.

Cấu hình hệ thống (Settings)

Thiết lập tại mục PolyUtilities > Settings để quản trị quyền hạn truy cập mô-đun PolyUtilities, bật/tắt Sticky Menu, thu gọn Sidebar hiển thị icon, kích hoạt phím tắt Ctrl+S hay nút cuộn nhanh lên đầu trang.

Các câu hỏi thường gặp (FAQs)

Tôi có thể tạo nhiều tệp JS/CSS tùy biến không?
Có, bạn có thể tạo số lượng không giới hạn các tệp JS/CSS tùy biến. Vui lòng đảm bảo các đoạn mã không xung đột lẫn nhau.

Có thể phân quyền trong mô-đun không?
Có, hệ thống hỗ trợ phân quyền xem, tạo, sửa, xóa chi tiết cho từng tính năng đối với từng nhóm vai trò.

Tôi có thể đề xuất thêm tính năng mới không?
Chắc chắn. Chúng tôi luôn ghi nhận các đóng góp hữu ích để đưa vào các bản cập nhật tiếp theo nhằm mang lại trải nghiệm tối ưu nhất cho người dùng.

Tại sao mô-đun không sử dụng các phím tắt như Ctrl, Shift, Alt làm hotkey?
Để tránh xung đột với các phím tắt mặc định sẵn có của hệ thống Perfex CRM và các phím tắt mặc định của trình duyệt web, mô-đun lựa chọn các tổ hợp phím tắt ít phổ biến hơn để đảm bảo điều hướng hoạt động chính xác.

Tôi có thể mua PolyUtilities ở đâu?
Mô-đun PolyUtilities được phân phối chính thức duy nhất thông qua hệ thống Envato (Codecanyon). Chúng tôi cung cấp dịch vụ hỗ trợ khách hàng độc quyền qua kênh này.

Lời cảm ơn

Một lần nữa, xin chân thành cảm ơn bạn đã lựa chọn mô-đun PolyUtilities cho Perfex CRM. Chúng tôi rất hân hạnh được hỗ trợ bạn. Bạn có thể để lại đánh giá phản hồi tại https://codecanyon.net/user/polyxgo để chúng tôi tiếp tục nâng cấp sản phẩm tốt hơn.

Lịch sử phiên bản

...