Getting started docs?
Posted: 03 July 2007 08:19 AM   [ Ignore ]
Jr. Member
RankRank
Total Posts:  52
Joined  2007-04-30

Hey all,

I’ve installed Freeform and kind of lost at what to do next.  I’ve read through the docs on this site, but am I missing a basic ‘getting started’ text.  The docs seem to jump right into the variables and parameters, but no clue about how to get started.

The examples that are shown for example, mention a use case with radio buttons. As I understand it, if you want to use a custom field on a form, you need to add it to the FF fields tab in the module admin.  But I only see the options for “Text Field” and “Text Area”...

Anyone know of a step by step type tutorial for getting started with FF?  I’m sure it’s me just being daft, as everyone else keeps saying how easy it is to use!  wink

Can I just create a form using Dreamweaver or something similar, and work backwords from there? Tx in advance!

Confused,

Ira

Profile
 
 
Posted: 03 July 2007 08:43 AM   [ Ignore ]   [ # 1 ]
Member
Avatar
RankRankRank
Total Posts:  292
Joined  2005-07-09

I suppose it is true that the docs expect a certain familarity with EE in general and (X)HTML in particular. Having said that, there are a few snippets that you can easily use. I mean, take example #1:

{exp:freeform:form}

<p>Name<br />
<
input type="text" name="name" value="" />
</
p>

<
p>Email<br />
<
input type="text" name="email" value="" />
</
p>

<
p>Question<br />
<
textarea name="question" /></textarea>
</
p>

<
p>
<
input type="submit" name="submit" value="submit" />
</
p>

{/exp:freeform:form} 

Quite straight forward, wouldn’t you agree?

As I understand it, if you want to use a custom field on a form, you need to add it to the FF fields tab in the module admin.  But I only see the options for “Text Field” and “Text Area”…

Yes. Radio buttons, checkboxes and dropdown selects are somewhat special cases, but are handled as “Text Input” fields on the backend side of things.

 Signature 

Ingmar Greil

Profile
 
 
Posted: 03 July 2007 08:58 AM   [ Ignore ]   [ # 2 ]
Jr. Member
RankRank
Total Posts:  52
Joined  2007-04-30

Hey Ingmar, actually I find each of the existing docs very straightforward for what they’re covering, it’s really just missing an intro statement with 3 or 4 bullet points saying how to tie it all together, and in what order.

I’ll keep working at it.  If you don’t mind, could you confirm that this workflow make sense:

1) Design a form in Dreamweaver, with all of the fields and layout elements I’ll need
2) If the fields are not generic ones that already exist in Freeform (name, email, country etc), create new fields for those
3) Add the form code to an existing template, but replace the standard form tags with the freeform tag
4) If I need to later query the results from the Freeform db table, I add a form ID to the freeform tag?
5) Once someone fills out the form, the form will be available in the Freeform admin panel?

Thanks much,

Ira

Profile
 
 
Posted: 03 July 2007 09:21 AM   [ Ignore ]   [ # 3 ]
Member
Avatar
RankRankRank
Total Posts:  292
Joined  2005-07-09

Yes, that should work. Well, except that I don’t work with Dreamweaver, so I don’t know what kind of code it generates. If you want to query the results, you would do so using the {exp:freeform:entries} tag.

The data will be available in the admin panel, too. Why don’t you try simple “hello world” kind of example yourself?

 Signature 

Ingmar Greil

Profile