Icon.png

Documentation

Frequently Asked Questions

Persistency

How can I make the contents of a Pier site persistent?

The built-in support is via the so called Image Persistency. This creates backups of the entire Squeak image with all the content. To setup the Image Persistency, go to http://localhost:8080/seaside/pier/environment/systemmanagement and choose it from the drop down.

Global appearance

How can I add new tabs? For now, I have "Home", "Blog", "About". What should I do to have a new entry here?

In the /environment/header you will see that it embeds a ==/> > > In the /environment/header you will see that it embeds a ==/ > environment/menu==. Navigate there, and you will further see that if you edit it, it’s not a page but

environment/menu==. Navigate there, and you will further see that if you edit it, it’s not a page but it is a component. Then invoke Settings and you can add a new item in the list. The nice property of the Menu component is that it adds an "active" class to the most specific link that it finds in the text of the component. This is how we can render the active tab.

How do I get different layouts in some pages? How do I create a new environment?

Add a page called MySpecialEnvironment to the root. Copy in there the contents from the page found in /environment. Add another page called MyPageWithSpecialEnvironment and in the Settings point the environment to be MySpecialEnvironment.

How can I change the top-most title? I have "Your Pier". How can I modify it? Or even better add an image

That is part of the "environment" of the page (or the template). You can take a look at it by invoking the Edit Design command. You will see that you actually have different environments for different pages (you see the name in the Location), but all embed (with "+") the /environment/header structure.

If you further navigate to /environment/header using the sitemap at the bottom, you will get to a so called meta page. If you edit the page, you will see that it embeds /environment/sitetitle. This is the title that appears at the top. Navigate there and edit it to add whatever you want.

How to change the browser title bar?

Go to /environment/contents, access the Settings and change the Head Title.

You have access to the following special constructs:

Construct Description
%ccurrent command
%rcurrent root structure
%tcurrent structure
%kcurrent kernel name

I added a new component in /environment, but it does not get displayed when I am not logged in. How can I fix it?

By default, the user rights of a newly added structure are copied from the parent one. Thus, given that /environment is a protected page, your newly added structure will also be protected. To make it be seen by others, you have to:

  • access Change Others
  • select View from the list
  • save

How to have a ’back to top’ link at the bottom of my pages?

Put a link *Top>.* to the bottom of your page. You can also use the ‘@-‘ syntax to jump to particular locations in a page.

How do I hide some elements in the menu on top?

There are different ways to do that: - Go to Settings of the element and select "Hide from menus" - Move the element under the _Environment page - Use the Menu component as explained here

How to add a download link to a file?

Add the file to your Pier website and link it like this:

+pathtostructure|download+

Security

How can I manage user rights?

Security is an access control layer for Pier that is similar to the UNIX security system for file access. It knows about users, groups, and permissions. For every command (such as View, Edit, Move a page) and every page you can assign access rights to ’user’, ’group’, and ’others’. The superuser has access to all commands. There are commands that let you change the security settings for a document and all its children.

Security offers three commands "Change Owner", "Change Group" and "Change Other". Select the page you want to change from the tree (e.g. the root page) and select "Change Owner". Check "Recursive", i.e. change all sub-structures as well. Select "Admin" from the Owner-Select-Box to make Admin the owner of everything. As Operator you want to have "Set". Finally you can specify the access to the different available commands for that user.

How do I change the admin password?

Go to /systemmanagement and edit the user.

Design

How to work with a special CSS for a particular page?

  • add a File (let’s say you created /environment/anothercss)
  • go to the page you want to add the stylesheet for
  • go to the settings of this page
  • in the stylesheet field add /environment/anothercss
  • access Edit Design command and you will have an editor for the new CSS file

How to refer to a Pier file from the CSS

Suppose you have a file in /environment/myfile. You can refer to it from CSS in the following way: url(/seaside/pier/environment/myfile?view=PRDownloadView)

How to change the size of an inlined image?

You can either set it via CSS, or directly using the following syntax: +image|width=300|height=200+

How to make texts appear below images?

Insert the following code between the image and the text:

<div style="clear: both"></div>

Structure

How to setup a blog?

  1. Invoke the Add command and select Blog from the dropdown menu.
  2. To get the archive in the blog, add an Blog Archive component somewhere else, and embed it in the environment of the Blog

How to post to a blog?

  1. Go to the blog
  2. Invoke the Add command and select Post
  3. Entry the content
  4. If you want to publish it for everyone to see, enter the publication date (you can also click on the current button)

How to delete a broken page/component?

  1. Go to the parent page
  2. Select the Browse View
  3. From the listing, choose the r corresponding to the Remove command

Others

How to deploy on seasidehosting.st?

  1. Go to http://www.seasidehosting.st
  2. Press the register button and create YOURDOMAIN.seasidehosting.st by following the indicated steps
  3. Copy via FTP to YOURDOMAIN.seasidehosting.st
    • the pier.image file
    • the pier.changes file
    • the files/ folder
  4. Go to seasidehosting.st and login
  5. Choose Filesystem (from the right menu), choose pier.image and press Start

Seasidehosting.png

Pages: