RESOLVED: Basic Tutorial please - How many times do we have to ask?

I know this question has been asked before, but it never seems to get properly answered.

Can we please, please, please have a clear and basic tutorial on how to set this up?

One for non programmers.

No steps left out and nothing left uncertain. Everything spelt out.

Just to get a basic example set up and functioning would be a tremendous help.

Once we have that, then we can probably take it on our own from there, but please we need that first worked example.

Thanks

Quote from: markg at May 20, 2008, 05:03 AM

"How many times do we have to ask?" Can we please, please, please have a clear and basic tutorial on how to set this up?
One for non programmers.
No steps left out and nothing left uncertain. Everything spelt out.

I would guess that most people don’t want to spend a lot of their (free) time for such documentation. This is free software, no one will get paid for making this very detailed manual you’re asking for.

All information you need is on this forum and in the snippet instructions, try it out and then ask here when you get stuck and I’m sure lot of people are willing to help out!

I personally don’t see an issue w/ Scotty’s documentation for the snippet. It explains pretty much everything related to the script.

Have you read the index.html file in the docs folder for this snippet? Read parameters.html throughly.

All you have to do is copy and paste the correct code from there into your MODx doc and it works. All of the files that WLPE depends on are in the WLPE directory. If you need to edit any of those, edit the file called webloginpe.templates.php.

MODx is almost too easy, and if you come from another CMS there might be a lot to unlearn.

I think the people that find it ’easy’ are the ones that have been using it for a while, and forgotten what it’s like to be starting it from scratch.

As a new user of WebLoginPE myself, I know how it feels - so you’ve downloaded the code, installed it as per the instructions - NOW WHAT?

The documentation that Scotty has provided is actually very good, ONCE you’ve got your head around how it actually all slots together, and this is where I was having my main problem

I think something very simple and easy to understand like:

On your Home Page or Site Template, put the Snippet call like [!WebLoginPE? &type=`simple`!] where you would like the Login Box to appear;
Create a New Page called Registration, and put a Snippet call like [!WebLoginPE? &type=`register`!]
Create a New Page called Profile, and put a Snippet call like [!WebLoginPE? &type=`profile`!]

You can customise each of these snippet calls, by adding parameters (see the Documentation), for example on your Registration Page, you could specify [!WebLoginPE? &type=`register` &groups=`Pending Users` &notify=`[email protected]` &regSuccessId=`74` &regSuccessPause=`3`!] to make new registrations be assigned to the Pending Users group, an email notification sent to [email protected], user will be taken to success page (page ID is 74), and pause for 3 seconds.

Once you realise that it’s THAT simple to actually set it up, it’s just a matter of working your way (slowly) through the documentation, and trying things. By the way, if more experienced users see anything wrong with what I’ve done above, PLEASE let me know, so I can fix it!!

(One thing that isn’t working for me is the &disableServices=`deleteprofile` parameter - I don’t really know WHERE to put it to make it work, eg on which page. I’ve tried putting it on my Profile page, but it doesn’t remove the Delete My Profile button :-( )

The next step is customising the templates, which is where I’m currently at. As far as I can see, this involves creating a new Chunk, calling it something like myLoginFormTpl, and adding to your parameter calls on the relevant page, eg [!WebLoginPE? &type=`simple` &loginFormTpl=`myLoginFormTpl`!].

Do you think the above contains enough to get people started?? What else does it need?

Cheers,
Jacob

Thank heaven for people like Jacob.

However, Jacob I have copied your instructions exactly as

On your Home Page or Site Template, put the Snippet call like [!WebLoginPE? &type=`simple`!] where you would like the Login Box to appear;
Create a New Page called Registration, and put a Snippet call like [!WebLoginPE? &type=`register`!]
Create a New Page called Profile, and put a Snippet call like [!WebLoginPE? &type=`profile`!]

and I get nothing. Or rather I just get a page actually showing the code. Obviously I’m missing something really simple, but I’ve no idea what.

Sorry in advance if this seems like a dumb question.

You have a page showing the snippet call you mean ?

Because if so, check very carefully for any mismatch between the way you named your snippet and the syntax in your call (for instance, if you named it WebloginPE and call it with WebLoginPE then nothing will ever happen... we’ve all been there ).

OK, I’ve looked at this till I’ve gone crosseyed.

Here’s my snippet call: [!WebLoginPE? &type=`simple`!]

This is my snippet name: WebLoginPE

This is what appears on my templated page: [[WebLoginPE? &type=`register`]]

Am I blind?

Not possible, a snippet has to be parsed if you don’t have any typo.

You must have messed up somewhere along the way... it happened to me and sometimes you go crazy with those little things...

Where is the snippet call : template, TV, chunk or content field ?
If it’s the template, check that you selected the right one.
If in the content field, check that you’re on the right document.
If it’s in a chunk, check the chunk for a typo
If it’s in a TV, also check for typos and also check TV’s type...

And don’t forget to clear the cache, sometimes cache issues are a bugger !

David,

not possible that I’m blind? Thanks.

Anyway, I assure you that what I pasted above is exactly what’s in the files.

As, I said I did exactly what Jacob instructed above.

The snippet call is on a page all by by itself, nothing else to get confused with.


Taking a slightly different tack, in the meantime I copied one of the example templates and pasted it into a new chunk and put that on a new page.

That at least gives a page that looks like it’s supposed to. Of course it’s not connected to anything, so I can’t login, but at least it looks like progress. Then again the code for this is completely different to anything Jacob was suggesting, so now I’m really confused.

Is there anyway at least to get the example files working together, or am I jsut going down a blind alley here?