CouchCMS • View topic - Tutorial issues from a newbie

Problems, need help? Have a tip or advice? Post it here.

3 posts Page 1 of 1

Tutorial issues from a newbie

: wysocki; Registered User

: Posts: 92; Joined: Sun Mar 06, 2016 6:50 am; Location: Los Angeles area

by wysocki » Sun Mar 06, 2016 7:09 am

Newbie here (programmer for 30 years though), did a search and found my issue, but there was no answer as to what resolved it. So along with that, I found a few issues so far while doing the Couch tutorial:

MINOR ISSUE:
For HTML5, the Doctype of each file should be just <!DOCTYPE html>

DIVING DEEP - THE BLOG (PART 1):
Where it says "the two editable regions we identified above", there's only one defined.
Where it says "Upload an image", there are no images accessible on the server.
Where it does the embed,
I have:

Code: Select all

</body>
</html>
<cms:else />
   <cms:embed '../../blog_list.html' />
</cms:if>
<?php COUCH::invoke(); ?>

I get:

"Error embedding file: /home/meuser/mysite.com/couch/snippets/blog_list.html"

If I move the file and try the ../ conventions named in the docs, I just get:

Error embedding file: /home/meuser/mysite.com/couch/snippets/../../blog_list.html

I have not added anything in the config.php regarding the snippets location.
HELP!

Re: Tutorial issues from a newbie

: KK; Moderator

: Posts: 8732; Joined: Wed Dec 01, 2010 5:35 pm

by KK » Sun Mar 06, 2016 6:44 pm

I'll try to resolve your confusions.

Where it says "the two editable regions we identified above", there's only one defined.

The 'above' referenced in the quoted statement is the paragraph that begins with the heading Identifying the editable regions. It states -

The content can be captured by creating a richtext type editable region.
..
The content of each blog entry in Aurelius has a 610px x 150px image.
To make it easy for the client to set such an image for each entry, we'll define a second editable region of type image.

So this way it identified the necessity of two editable regions to capture the contents - a 'richtext' and an 'image' region.

Following which, the tutorial then defines the two regions -

: portfolio-site-24.png (2.9 KiB) Viewed 1817 times

The two should appear in the admin-panel as follows -

: portfolio-site-25.png (17.09 KiB) Viewed 1817 times

Where it says "Upload an image", there are no images accessible on the server.

Clicking the 'Browse server' button if the 'image' editable region we created above should pop-up a file explorer. If you see no images within it, that would be because you have not uploaded any image to the server yet. The file explorer can be used to select images from your local machine and upload them to the server. Please do so and you'll see thumbnails of the uploaded images.

I get:
"Error embedding file: /home/meuser/mysite.com/couch/snippets/blog_list.html"

The correct statement for using embed, as shown in the tutorial' would be

Code: Select all

<cms:embed 'blog_list.html' />

No path info is required as the tag expects the indicated snippet to be present within the 'snippets' folder (by default this would be 'couch/snippets').

From the error message, it is clear that Couch *is* looking for the snippet in 'couch/snippets/' but is unable to find it. So please make sure that the 'blog_list.html' is indeed present in that folder (perhaps the underscore in the name got mixed up by an hyphen).

Hope that answers your queries.

Re: Tutorial issues from a newbie

: wysocki; Registered User

: Posts: 92; Joined: Sun Mar 06, 2016 6:50 am; Location: Los Angeles area

by wysocki » Mon Mar 07, 2016 2:46 am

Thanks for the quick reply!
I have to take the blame here (shouldn't do tutorials at 3AM)!

I didn't notice the TWO region definitions and I must have been asleep when I read the part about uploading an image. And you were right, it WAS the hyphen/underscore that caused the "file not found" problem. HOWEVER, when I did try the ../../ method suggested in the docs under "EMBED", the path was not resolved correctly and resolved to /home/meuser/mysite.com/couch/snippets/../../blog_list.html instead of /home/meuser/mysite.com/blog_list.html as it should.

One other minor typo in that tut was that the Virtual Folders List is not in the Advanced section anymore, it's just in the main edit screen.

Thanks for a great product (and great support), I look forward to getting deep enough into it to use on my site designs.

Post a reply

Previous Next

3 posts Page 1 of 1

Return to Bug Reporting and Troubleshooting