Skip to content

Commit d4892cc

Browse files
authored
Create content-types.md
1 parent a191998 commit d4892cc

File tree

1 file changed

+75
-0
lines changed

1 file changed

+75
-0
lines changed

build/content-types.md

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,75 @@
1+
---
2+
layout: document
3+
category: Construction and Presentation
4+
published: false
5+
title: Content types
6+
description: Core content types, custom content types, and designing site architectures with these kinds of content needs in mind.
7+
---
8+
9+
# Content Types
10+
11+
Intro...
12+
13+
**Contents**
14+
15+
* Table of contents
16+
{:toc}
17+
18+
## Articles
19+
20+
## Images
21+
22+
## Files
23+
24+
## Links
25+
26+
## Comments
27+
28+
## Authors
29+
30+
## Categories
31+
32+
## Custom fields
33+
34+
Custom fields enable you to add site-specific content to your articles that extend the scope of the core fields defined above.
35+
36+
### Defining custom fields
37+
38+
On the Preferences panel, click the **Custom fields** item to see input text boxes for defining up to ten fields that will appear on the Write panel when defined.
39+
40+
#### Important notes on creating custom field names
41+
42+
Custom field names may include letters (uppercase or lowercase), numbers, and under scores, but no spaces or other special characters should be used. For example, `custom1`, `Custom1`, `Custom_1`, `Location` and `Project_name` are all valid name constructs, while `custom 1`, `custom !` and `Project name` are not.
43+
44+
Also, there are certain names **reserved** by Textpattern, which should *not* be used to name custom fields. Doing so will likely cause your site to not work as expected.
45+
46+
**Do not use the following for custom field names**:
47+
48+
* annotate
49+
* article_image
50+
* authorid
51+
* body
52+
* category
53+
* category1
54+
* category2
55+
* comments_count
56+
* comments_invite
57+
* excerpt
58+
* form
59+
* id
60+
* keywords
61+
* limit
62+
* offset
63+
* posted
64+
* section
65+
* sort
66+
* status
67+
* thisid
68+
* title
69+
* url_title
70+
* Or any other [tag attribute](/tags/tag-attributes-cross-reference), just in case!
71+
72+
A symptom of a name clash is when you go to check or display the contents of a custom field in an article and receive unexpected (or no) output. In this case, make sure your custom field names are not any of the reserved names listed above.
73+
74+
To remove a custom field, simply clear its name and save the changes.
75+

0 commit comments

Comments
 (0)