Forums and documentation

Typo in documentation?

Tue, 14 May 2013 15:54:40 GMT

Jason Bradberry

Hi

Is this a typo in the documentation? The Paypal shop installation page refers to Foxyshop, in the Perch Configuration paragraph.

http://docs.grabaperch.com/docs/shop-paypal/installation/

Jason

14 May 2013, 04:54 PM

Drew McLellan

Yes, that's a typo.

38 mins since original post

Admin User Guide

Fri, 3 May 2013 15:39:14 GMT

Lee Hampton

We use Perch on all our projects and while our team of developers find the support documentation really good, there is no documentation (as far as I can see) which shows the client (end user) the basics of using Perch's admin area.

Are there any plans for a short pdf which runs through the basics, so it can be given to a client? I understand that each site is different but having something that covers the fundamental basics would be a big help to be able to leave with a client rather than having to go through it each time or doing screen casts etc etc.

Thanks in advance.

3 May 2013, 04:39 PM

Drew McLellan

What sort of thing would you like it cover?

We discussed this a bit on podcast 004 - the problem being that most end-user documentation is task based, and the tasks vary from site to site.

24 mins since original post

Lee Hampton

Hi Drew,

I appreciate that it's a bit of a difficult thing, I was thinking more along the basic structure of the backend, so something that explains, what each element links to, how pages work, what the page regions area is for, whats the difference between a page title and a navigation title (i know for people in the know they understand page title is the meta title at the top) but our clients are a lot less tech savvy. Explaining what regions are and how you delete a page would be good, that type of thing.

So for example, in order to change a user password, it seems the right route is to go to roles and then edit the user, but you actually have to go to 'My Account' in the top right to edit this.

It is more something that gives a good overview, even a screen cast based on a standard backend would be useful as we could then give them as a reference for them to get to grips with it.

By the way just as a side note, we all think your CMS is cracking.

3 days, 23 hours since original post

Suggestion: formatting in the textfields of the forum ( tabs )

Wed, 1 May 2013 16:45:37 GMT

Henryk

Hello dear perch team,

as I asked some question here already and was posting code along.
I would like to suggest or better said, it would be great to have.

Formating!

For the readability of the code.
Basically I put the code with tabs in the text fields and after posting they're always gone.
That's a pitty!

When I find code in an topic that might deal with the same problem I have. I usually copy the code in my text editor and put all the tabs and so on until I found it more readable.

Well that said, I'm happy I find help here.

Best,
henryk

1 May 2013, 05:45 PM

Drew McLellan

It's a frustration for us too. We're using a third party system (HelpSpot). If we stopped to write our own, there'd be no progress on Perch for months.

1 hour, 51 mins since original post

Allow access to specific regions for individual Members

Sat, 20 Apr 2013 14:22:32 GMT

Alan Rowe

I'm looking at building a site with individual image galleries on different pages for different artists, which seems to be possible using the members app.
However I also want each member to be able to upload an image to a page with different regions displaying an image for each artist. Each region on the page might be labelled something like Artist 1, Artist 2.... etc

I've only just installed the app and can see already it's possible to limit which members can edit which pages, using the restrict access by tag option.
Is it possible to something smilar with regions?
Ie on a page with multiple regions, to only give access to a specific region to a specific member?

Hope that makes sense!

20 Apr 2013, 03:22 PM

Drew McLellan

Yes, you'd wrap the region in a check for the tag.

if (perch_member_has_tag('artist1')) {
perch_content('Artist 1 region');
}

26 mins since original post

Alan Rowe

I've added this to the HTML

if (perch_member_has_tag('artist1')) {
perch_content('Artist 1 region');
}
?>

Is that correct?

Nothing is showing in the regions list. ( I've revisited the page in the browser and refreshed the page in the backend) I'm guessing this is because I'm not logged in as the member with the artist1 tag.
I'm developing locally and have checked the notify by email button, on the add new member page, but not received an email.

I seem to be missing something.

1 hour, 9 mins since original post

Alan

Hi Drew, apologies if I'm being thick.
Just been trying to get my head around things a bit more. Please can you confirm if I've got this right?

Members can't edit content.

Users CAN'T be given sole access to specific pages so that only User 1 can edit Page 1 , only User2 can edit Page 2 etc...

Therefore it's not possible to create a site where several users ( or members ) all have specific pages/regions they and they alone can edit?

Thanks.

3 hours, 51 mins since original post

Drew McLellan

That's correct. Users can edit content. Members can only update their own profiles.

4 hours, 31 mins since original post

Alan

Ok, thanks.
Are there any plans to make it possible for users to be restricted to editing a page assigned only to them?
I noticed in older posts the same question has been asked.

It's the one thing currently making it unlikely for me to use perch for a site with multiple contributors. I suspect I'm not the only one who'd love to see the option added...but I appreciate it's not possible to please all of the people all of the time!

2 days, 3 hours since original post

Drew McLellan

Would you not create a user account for someone to edit content?

2 days, 6 hours since original post

Alan

Maybe I'm missing something obvious?
I need to create several user accounts, with each user only able to access their own page but not pages assigned to other users.
I can't work out any way to restrict permissions for individual users in this way. Basically to prevent any user messing up another user's content.
Apologies if I'm being vague or missing something very basic...

2 days, 7 hours since original post

Alan

Looks like I WAS missing something obvious...D'oh!
It seems the answer lies in creating a new ROLE for each user,
USERS > Roles > +Add Role

eg. user1

Then under Region Options allow only user1 permission to edit that region.

Repeat the process for each user.
Took a while for the penny to drop!

2 days, 8 hours since original post

Nathan

This is just what I'm after although I did want the ability for users to register themselves.

Basically I have several plots of land that have sold to various people. I would like a buyer to have the ability to register, then add a testimonial on a dedicated page.

If adding users is the only way then that should be fine.

2 weeks, 1 day since original post

how to adding html code

Tue, 16 Apr 2013 08:59:18 GMT

duncan

How do i add html code to perch. I want to add a horizontal rule < /hr> to the page where do i add the code? or can I do it another way?

16 Apr 2013, 09:59 AM

Rachel Andrew

You can add any HTML you like you your templates.

http://docs.grabaperch.com/video/creating-templates/

6 hours, 31 mins since original post

Uploading files through the CMS

Thu, 11 Apr 2013 10:23:20 GMT

Ola

Hi all,

I was just wondering if it was possible for the end user to upload files to a folder that I could display on a members only page ready for download? I'm using the members add-on but having trouble displaying the files - any pointers would be greatly appreciated.

Last question is whether the client could upload files directly from the cms to be displayed on the page? Or would they need to upload these files through the front-end? (I expect the files will probably be limited to pdfs and word documents, but would like to tailor it for anything)

Many thanks,
Ola

11 Apr 2013, 11:23 AM

Drew McLellan

There's nothing to do that currently.

3 hours, 54 mins since original post

Add Page documentation appears to be wrong/problematic

Mon, 1 Apr 2013 08:48:34 GMT

Thomas Green

In view of your request for help in improving Perch documentation, I would like to alert you to a problem area for Perch newbies. It's had me tangled lots of times.

In the 'Add page' dialogue the File name field help text says "The file extension will be created automatically". This seems to be wrong, or at least the Perch navigation system gets confused. After getting tangled on this issue many times, I think I've sorted out what actually happens and where the problem is.

I'm creating a Perch page for a page that already exists, called /cats.php.
When I put 'cats' in the Page title field, the file name field defaults to 'cats'. If I leave that as is, the navigation link provided by perch_pages_navigation points to '/cats', which of course doesn't exist.

If I put 'cats.php' in the field the navigation works fine. But that definitely is not what the Help text tells me to do.

Also .... I read that page references should always be root-relative. Obediently I try to follow instructions. That works nicely for content_custom. But if I follow that advice when creating a new page, I get a surprise. If I enter /cats.php, making the link root-relative as instructed, then next time I look at page options, it says '//cats.php".

There are two problems here, or so it seems to me. (1) The help text shouldn't say that the extension will be added, because it isn't added. (2) The / behaviour should be consistent. If I'm required to write root-relative file names in one context, then I should at least be allowed to write root-relative file names in another context. [I've done HCI research on issues of consistency: believe me, this sort of inconsistency tangles beginners up badly.] You could fix the inconsistency in various ways; for example if the field that's input already starts with / you could open a dialogue to say "the address should be normally start with / not //, shall I change that?"

I hope this will be a helpful comment. It's meant to be!

1 Apr 2013, 09:48 AM

Drew McLellan

Thanks, we'll take a look at it.

55 mins since original post

Contradicting information when managing users

Thu, 21 Mar 2013 15:31:17 GMT

Chip

When managing users, under the Users Details section it says, "Send a new password by email" with a checkbox next to it. In the Help and Support section in the sidebar on the right it says, "If you do not wish to send a new password by email, just check the box." Which would be the correct information?

21 Mar 2013, 03:31 PM

Drew McLellan

"If you wish to send a new password by email, just check the box."

2 hours, 23 mins since original post

V1 versions of Perch for Updating to V2

Wed, 20 Mar 2013 11:42:59 GMT

George Crockford

I have a number of sites that need updating and some of them need updating to 1.8x in order to run the update tools and not suffer issues with the DB updates from v1 to v2. Could you provide a v1.x download section for previous versions of perch so that we can update old v1 sites to the most recent v1 build before I go to v2.

Luckily I did find a 1.8x install in my downloads but this may give other people problems if they are upgrading so though it may be worth suggesting a download section for older versions in case anyone else requires them for upgrading sites to v2.

Cheers

George

20 Mar 2013, 11:42 AM

Drew McLellan

You can download 1.8.4 from your account before applying the upgrade to a license.

1 hour, 27 mins since original post

Empty
items on List and detail page

Fri, 8 Mar 2013 04:33:20 GMT

Adam Brace

I followed the instructions to create list and detail functionality on my site. However on my list page im seeing 7 empty list items in my markup before the first post. Any idea how I can resolve this?

8 Mar 2013, 04:33 AM

Rachel Andrew

Please post the code that you are using for that section.

1 hour, 55 mins since original post

Drew McLellan

Also, double check your region name and page path are correct.

If you're getting blank items, that usually means that Perch can't find the region you're asking for as so the content isn't being filtered to just that region like it should be.

3 hours, 12 mins since original post

Adam Brace

I double checked the region name and page path and the region was incorrect so I updated it but still having the same issue.

Heres the code.

Project page

$opts = array(
'template'=>'project.html',
'filter'=>'slug',
'match'=>'eq',
'value'=>$_GET['s']
);
perch_content_custom('Project', $opts);
?>

Project template

" alt="" />

Work Page

_projectlisting.html template

9 hours, 16 mins since original post

Drew McLellan

Can you try adding the following to your `perch/config/config.php` file:

define('PERCH_DEBUG', true);

and then add the following to the bottom of your page and let me know what it outputs?

10 hours, 8 mins since original post

Adam Brace

Okay done.

DIAGNOSTICS:
SELECT regionID, regionTemplate, regionPage, regionRev AS rev FROM perch2_content_regions
WHERE regionKey='Project' AND (regionPage='project.php' OR regionPage='*')
SELECT * FROM ( SELECT idx.itemID, c.regionID, c.itemJSON, idx2.indexValue as sortval FROM perch2_content_index idx
JOIN perch2_content_items c ON idx.itemID=c.itemID AND idx.itemRev=c.itemRev AND idx.regionID=c.regionID
JOIN perch2_content_index idx2 ON idx.itemID=idx2.itemID AND idx.itemRev=idx2.itemRev AND idx2.indexKey='_order' AND idx.itemID=idx2.itemID AND idx.itemRev=idx2.itemRev
) as tbl GROUP BY itemID ORDER BY sortval ASC
Using template: /templates/content/_projectlisting.html

11 hours, 37 mins since original post

Drew McLellan

I think this:

'page'=>'project.php',

should be:

'page'=>'/project.php',

paths need to be root-relative.

15 hours, 35 mins since original post

Adam Brace

I implemented this but I still seem to be getting the blank items

16 hours, 58 mins since original post

Drew McLellan

Can you update to 2.1.4 and see if that changes anything?

1 day, 5 hours since original post

Adam Brace

Updated but still getting same issue

2 days, 12 hours since original post

Drew McLellan

Can you show me the debug output?

2 days, 15 hours since original post

Adam Brace

I dont think I did the update properly first time round as I was seeing 2.1.3 so I retried the install and now im seeing 2.1.4 I removed all items relating to the list and details pages and decided to try again to see if it made a difference.

Multiple times trying to implement the list and detail integration and im not seeing anything in my list page, the details are working as they should I followed the same instructions and its just not working at all. I'm really stuck and its getting pretty frustrating now.

project page

work page

Project listing template

Project template

" alt="" />

Heres the debug im now seeing on my list page (work.php)
DIAGNOSTICS:
SELECT regionID, regionTemplate, regionPage, regionRev AS rev FROM perch2_content_regions
WHERE regionKey='project' AND (regionPage='/project.php' OR regionPage='*')
No matching content regions found. Check region name (project) and page path options.
SELECT * FROM ( SELECT idx.itemID, c.regionID, c.itemJSON, idx2.indexValue as sortval FROM perch2_content_index idx
JOIN perch2_content_items c ON idx.itemID=c.itemID AND idx.itemRev=c.itemRev AND idx.regionID=c.regionID
JOIN perch2_content_index idx2 ON idx.itemID=idx2.itemID AND idx.itemRev=idx2.itemRev AND idx2.indexKey='_order' WHERE idx.regionID IS NULL AND idx.itemID=idx2.itemID AND idx.itemRev=idx2.itemRev
) as tbl GROUP BY itemID ORDER BY sortval ASC
Using template: /templates/content/_projectlisting.html

2 days, 21 hours since original post

Forums and documentation

Typo in documentation?

Admin User Guide

Suggestion: formatting in the textfields of the forum ( tabs )

Allow access to specific regions for individual Members

how to adding html code

Uploading files through the CMS

Add Page documentation appears to be wrong/problematic

Contradicting information when managing users

V1 versions of Perch for Updating to V2

Empty items on List and detail page

Empty
items on List and detail page