Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This document describe best practice when create new page / template / widget in DOTCMS. It contain 3 part of building a page: 

...

Enter needed information to create page, fields with Red title in required
1. Title: all characters are in normal case (a-z), dont use special characters & capital characters

2. Url: example: demo.html

3. Host or Folder: choose current folder & site

4. Template: select created template (in previous step) or a default template

5. Friendly name: Site Title

In Advanced Properties tab. you can configure below information:

...

2. Campaign Webkey: Used for Index - Pre-sale & Order page (most important). To declare webkey which is used to get price from CRM

3. Campaign Name: enter campaign name of entered webkey for better management. DONT LEAVE THIS BLANK if you already entered webkey.

4. GTM: Leave this blank if this page inherit GTM key of the site. 

Click Save/Publish để kết thúc quá trình tạo page. Giao diện trang mới tạo sẽ như bên dưới

Image Removed

Sử dụng Js (Javascript) trong trang

1. Vào thư mục src/js tạo hoặc upload file js cần sử dụng lên (ví dụ như trong hình dưới, file demo)

Image Removed

Image RemovedImage RemovedImage Removed to initiate page. 

  • How to Add JS to page

1. Go to src/js folder and create new js folder as below: 

Image Added


2. Go back to page editor and add new widget to last container (last "add content" button). 

Image Added

3. Find and select [SiteComment]AddstaticFileWidget, các static file đã được sử dụng trước đó sẽ hiện ra bên phải, nếu file muốn add đã tồn tại rồi, chỉ cần tìm và chọn select, file đó sẽ được add vào page (chú ý: đối với những widget không có [common] ở đầu câu thì không nên reuse lại những project của khác để sử dụng). Nếu static file này chưa tồn tại, chúng ta có thể bấm vào Create New để tạo mới

Image Added

4. Điền các thông tin cần thiết để tạo widget

Image Added

- Widget Title: Nhập vào title cho widget. Chú ý: để cho để dàng tìm kiếm widget sau này, nên replace tất cả khoảng trắng hoặc dấu - thành dấu _ . Quy tắc này nên được app dụng cho việc tạo content và widget.

- File Type: Chọn Javascript

- URL: chọn đường dẫn chứa file js, như lúc nãy chúng ta upload file demo.js lên thư mục /src/js/, do đó ngay tại vị trí này sẽ dùng là /src/js/demo.js

-  Type: Trong mục này có nhiều option, thường sử dụng nhất là Lib và Page (đối với những js mà chỉ dùng riêng cho trang này thì chúng ta nên chọn là Page. Không nên chọn None ở mục này, nếu không khi build sẽ bị lỗi)

- Site or Folder: Default là project đang select

- Click Save / P

3. Create & Add Widget 

  • Go to menu Types & Tag → Content Types 

...