How to create a cardtype

animal

tags

Every card has a Cardtype.  How do create new types?

Every Cardtype is represented by a Cardtype card.  There is a card named RichText, another named "Phrase", one named "User", "Image", "Setting", etc.  Each of these cards has the type "Cardtype".

 

To create a new Cardtype all you have to do is create a new card with the type Cardtype.

The steps for creating a Cardtype are the same as for any other card.  There are lots of ways to do that.

animal

tags

Cards are the basic building blocks of Wagn sites.  How do you create them?

There are many ways, including via:

  1. a link to a blank card
  2. a link to an unused name
  3. a link to create a specific type
  4. the navbox
  5. a direct url
  6. an nesting

The variety of tools makes it possible to create intuitive, customized means for end users to contribute information to your site without even needing to know what a "card" is.

Let's go through each of the solutions above and learn both how to use them and how to wagneer them to make them easy for others to use.

 

link to a blank card

On the menu of every new wagn, there is a link to Add a card.  You can add this link anywhere with this Link Syntax:

[[/card/new | Add a card]]

After clicking that link, you can add a name, choose a type, add some content, and click "Submit".

 

link to an unused name

As with most wikis, you can link to cards that don't yet exist and then click to create them.  For example, this simple Link Syntax...

[[A Flying Hippo]]

...will yield this: A Flying Hippo. The red color indicates that "A Flying Hippo" has not yet been created.  If you click the link, you can then choose a type, add some content, and click "Submit" to create it.  Please don't create this card!  That would falsify this doc, because after creating the card the link would turn green to indicate that the card exists.

 

To experiment with any of the methods described here, please feel welcomed to create away at sandbox.wagn.org

 

link to create a specific type

Let's say you have created a Registration type to have users register for an event.  You'd probably rather not make them select "Registration" from a type dropdown.  Instead, you'd like to have a link that immediately opens up the registration form.  Here's how:

[[/new/Registration | Register Here!]]

This will give you a link like this: Register Here!.  After clicking that link, you won't see a type dropdown, because the type is already set.  But you will see a name field (unless you're using autonaming), and the content area will match the Registration type.

 

 

search bar

Wagn's search bar can do more than just search.  For example, if you type "A Flying Hippo" into the search bar above (or, better yet, into the search bar on sandbox.wagn.org), you will see the following options:

 

  1. Search for: A Flying Hippo
  2. Add new card: A Flying Hippo

 

Option #1 does what search bars usually do: performs a search for cards that match those keywords.  Option #2, however, lets you create a new card with the name "A Flying Hippo", just as in the link to an unused name section above.  This method is useful when you want to confirm the name's availability or when you don't see a convenient create link on the page.

 

direct url

Wagn has very simple URL Syntax.  Almost every page is constructed around viewing a card, for which the path is:

/wagn/cardname

Many Wagneers often create new cards by directly editing the cardname in the browser, which takes you directly to a card creation form with the name prepopulated.  Note that with this solution you will need to use underscores "_" in place of spaces in card names. So to create our flying hippo on the sandbox wagn, the url would be: http://sandbox.wagn.org/wagn/A_Flying_Hippo

 

inclusion

Just as you can link to a card that doesn't exist, you can also include such a card within another.  For example, this Nest Syntax:

{{A Flying Hippo}}

...yields this link:

Clicking that link will prompt you to add the new card in place - without being taken to a new page.  The process is the same as all the Flying Hippo examples above; you still choose a type and add content and click submit.  But with inclusions, you are never taken out of your original context.

 

As with any other type, you can create a direct link to create a Cardtype card like so:

add new Cardtype

In fact, by default, such a link already appears on the Cardtype card (though not on wagn.org, which uses that card for documentation).