iBoard Import
iBoard Import is a shortcode generator for displaying one or more board lists inside a page. Administrators can select boards, configure display options such as row count, length, notice posts, skin, layer, category, and sorting method, then copy the generated shortcode into a page.
Use this feature when you want to show board posts inside a page without manually writing board list code. After the shortcode is inserted into a page, iBoard renders the selected board list automatically.
Overview
The iBoard Import page helps administrators generate board list shortcodes. Instead of manually writing code, you select the board and options from the screen. The system then creates a shortcode that can be copied and pasted into a page, layout, or content area.
| Area | Description |
|---|---|
| Board Selection | Selects one or more boards to include in the generated shortcode. |
| Import Settings | Configures display options such as row, length, notice, skin, layer, page ID, category, and order. |
| ShortCode | Displays the generated shortcode that can be copied and inserted into a page. |
| Preview | Allows administrators to review how the generated board list may appear before using it. |
What This Feature Does
iBoard Import creates a shortcode like the following:
[list, row:10, lenth:30, notice:true, orderby:comment, layer:radix_boxton, id:1, Skin:NewsV]When this shortcode is inserted into a page, iBoard reads the options and displays the matching board list. This allows board content to be reused in different pages or layouts.
Board Selection
The Board Selection area displays available boards. Select one or more boards to generate a shortcode.
| Option | Description |
|---|---|
| Board Checkbox | Selects an individual board to include in the shortcode. |
| All | Selects all available boards. |
| Name | Shows the name of the board that can be imported. |
Selecting boards automatically updates or generates the shortcode. Always confirm that the correct board is selected before copying the shortcode.
Import Settings
Import Settings control how the selected board list will be displayed. These options are converted into shortcode parameters.
| Setting | Shortcode Parameter | Description |
|---|---|---|
| Row | row |
Controls how many posts or rows are displayed in the list area. |
| Length | lenth |
Controls the maximum text length or display length used by the list. |
| Notice | notice |
Controls whether notice posts are included or displayed. |
| Skin | Skin |
Selects the board list skin used to display the imported board. |
| Layer | layer |
Selects the layout layer or display style used by the shortcode. |
| Page ID | pageid |
Connects the shortcode to a specific page when required. |
| Category | category |
Filters the board list by a category value. |
| OrderBy | orderby |
Controls the sorting method, such as newest, comment, or another supported order type. |
| Board ID | id |
Identifies the selected board. |
ShortCode Area
The ShortCode area displays the generated shortcode. Click the shortcode area or copy button to copy the generated value.
[list, row:10, lenth:30, notice:true, orderby:comment, layer:radix_boxton, id:1, Skin:NewsV]After copying the shortcode, paste it into the page content, layout section, or editor area where the board list should appear.
Example Shortcodes
Basic Board List
[list, row:10, lenth:30, notice:false, orderby:nothing, layer:radix_boxton, id:1, Skin:NewsV]This displays 10 posts from board ID 1 using the selected skin and layer.
Board List with Notice Posts
[list, row:10, lenth:30, notice:true, orderby:nothing, layer:radix_boxton, id:1, Skin:NewsV]This includes notice posts in the board list.
Board List Ordered by Comments
[list, row:10, lenth:30, notice:true, orderby:comment, layer:radix_boxton, id:1, Skin:NewsV]This displays the board list using comment-based ordering when supported.
Category-Specific Board List
[list, row:5, lenth:50, notice:false, orderby:nothing, layer:radix_boxton, id:1, category:news, Skin:NewsV]This displays only posts matching the selected category.
How to Use
- Open Admin > iBoard > Import.
- Select one or more boards from the Board Selection area.
- Configure the import options such as Row, Length, Notice, Skin, Layer, Category, and OrderBy.
- Review the generated shortcode in the ShortCode area.
- Click the shortcode area or copy button to copy the shortcode.
- Open the page where the board list should appear.
- Paste the shortcode into the page content or layout area.
- Save the page.
- Preview the page and confirm that the board list appears correctly.
Where to Paste the Shortcode
The generated shortcode can usually be pasted into areas that support iBoard shortcode rendering.
- Page content editor
- Core Page layout area
- Board layout section
- Skin or template content area
- Custom HTML area that supports shortcode parsing
If the shortcode appears as plain text instead of rendering a board list, the area where it was pasted may not support shortcode rendering.
Recommended Workflow
- Decide which board should appear on the page.
- Confirm that the board is active and visible.
- Select the board from iBoard Import.
- Select the correct skin and layer.
- Set row count and display length.
- Choose whether notice posts should be included.
- Choose the sorting method.
- Copy the generated shortcode.
- Paste it into the target page.
- Preview the page and adjust options if needed.
Common Use Cases
| Use Case | Recommended Setup |
|---|---|
| Show latest news on the homepage | Select the news board, set row to 5 or 10, and use a news-style skin. |
| Show notice posts on a landing page | Set notice:true and select the notice board. |
| Show popular posts | Use an order option such as orderby:comment when supported. |
| Show category-specific posts | Enter a category value and confirm that posts use the same category. |
| Embed a board list inside a custom page | Copy the generated shortcode and paste it into the page editor. |
Important Notes
- The selected board must exist and be available.
- The board should be visible if it needs to appear publicly.
- The selected skin must exist and support the selected layout.
- The selected layer must be compatible with the skin.
- If category filtering is used, the board posts must have matching category values.
- If the shortcode is pasted into an unsupported area, it may display as plain text.
- After changing board settings, preview the page again.
Troubleshooting
| Problem | Possible Cause | Solution |
|---|---|---|
| Shortcode appears as text | The page area may not support shortcode rendering. | Paste the shortcode into a supported page or layout area. |
| Board list does not appear | The board ID may be wrong, the board may be hidden, or the board has no posts. | Check board ID, display settings, and board posts. |
| Wrong design appears | The selected skin or layer may not be correct. | Select the correct Skin and Layer, then copy the shortcode again. |
| Notice posts are missing | The notice option may be false or the board may not have notice posts. | Set notice:true and confirm notice posts exist. |
| Category filter does not work | The category value may not match the board post categories. | Check the category spelling and post category values. |
| Sorting does not change | The selected orderby option may not be supported by the skin or board type. | Use a supported order option or check the board skin logic. |
Best Practices
- Use clear board names before generating shortcodes.
- Use a small row count on homepage sections.
- Use a larger row count for dedicated board list pages.
- Preview every shortcode after pasting it into a page.
- Keep a record of important shortcodes used in major pages.
- Do not delete or rename skins used by existing shortcodes.
- When changing shortcode options, copy the newly generated shortcode again.
iBoard Import is useful because it allows administrators to reuse board lists anywhere shortcode rendering is supported. Select the board, configure the options, copy the shortcode, and paste it into the page where the board list should appear.