- Adding a new post
- Updating or deleting a post
- For those who happy with raw HTML
- Adding existing documents
Posts are used for news items and other announcements such as results, club news and public news. When you create a post you must assign it a category – this determines where in the website the post will be displayed.
If you have any problems with these instructions please submit a ticket. You should get a fairly prompt response though on a best efforts basis. Please do use the ticket or helpdesk system then we can not only attempt to address your problem but also improve the instructions.
You will probably want your club website in a browser window next to this window holding the instructions.
This is quite a long web page with a lot of information. It is suggested that you read it all through once before starting.
As a user who has the role of contributor or author you can write posts. Editors and admins can also write posts. As a contributor your post must be approved before becoming public.
Adding a new post
To write your own news item to appear on the site, you need to create a “post”.
Click on +New (or just + on a phone or small tablet) at the top of the page and choose “Post” from the menu.
You’ll see the text editor window. Write a title in mixed case and write the first paragraph of the post in the large box below. Hit enter/return and enter a second paragraph. The enter/return, which will now just be referred to as enter, creates a new block holding a new paragraph and is effectively a “short cut”. Other short cuts can be displayed by Shift-Alt-h. To force a new line then you can enter Shift-Enter
Just above the block window there are a number of controls that you can use to format the current block. The first set of controls is peculiar to current block type and those on the end with the icon are common to all blocks and include a button to remove a block. For a block of type “Paragraph” you can change the justification of the whole paragraph, embolden or italicise selected text add links (see below) or use use crossed-out text.
At the top left corner of the editor are five icons – the first adds a new block, the second is Undo (Ctrl-z) and the next is Redo (Shift-Ctrl-Z). The circled “i” provides a useful clickable document summary and the final icon is similar though perhaps less useful.
At the top right hand corner of the editor are five icon/text areas. These can change depending upon the status of the post. Initially only the two right most are enabled but as soon as some content is entered then the other three are enabled. Click the big blue Publish button, and your post can be made visible on the site. You will actually remain in the editor but a link will appear at the top of the editor page inviting you to view the page. The preview button opens another window to see how the post will look – don’t try to edit the preview. After you have published a post then “Switch to Draft” simply unpublishes the post but leaves it open in the editor in its current state. The toggles the information displayed below on either the whole post (document) or the current block and the should be explored – you might lik to select view Top Toolbar might .
Your club webadmin will have defined a set of categories to which you can assign your post. On the right there’s a box for selecting the category. A default category will already have been set for you. You are able to select more than one category but this is generally not a good idea.
The category controls where on the web site your post will appear. As initially distributed there were three categories: News (the default and visible to the public), Club News which only show up in the Members’ Area and Competitions. All posts which are not public should be marked as “Hidden” in the post restriction in the bottom right hand corner of the editor. Failure to mark something as hidden will allow it to be found by a search though it is not accessible from a menu. Unfortunately someone logged in on another website using the same infrastructure will still be able to see your hidden posts by using the search box.
Please avoid using all capitals in post titles and headers. WordPress has been configured to associate a style with each header level. This association may be changed in the future which may invalidate tweaks that you have made.
You can use bold and italic options in moderation – but avoid the underline as it makes the text look like a link.
You may want to embed links within content, so a user can jump from one part of the site to another. For example you may want a news item about an open day which links directly to your Open Day page.
Highlight the text you want to link, and click the chain link button at the top of the window.
Click on the cog wheel and select the page to which you wish to link. You can type in the search box to find the post or page.
If you’re linking to another website, you will need to type in the URL and probably select “Open the link in a new tag” .
Finally click the blue “add link” or “update” button and you’re done.
Adding email addresses
As well as linking to a page within the site, or a page in an external site, you can link to an email address. That will open the user’s normal email program so they can send a message. Type the email address, select it, click on the chain link button and then the carriage return button.
Create an Image Block where you want it – just like any other block. This will give you the opportunity to use an image already in the media library or more likely add your own. An image block includes icons for align left, centre and right to allow text to flow round the image. You may also choose to create an Inline Image Block
For a video the simplest solution is to upload to You Tube unless it is already there then create a You Tube Block. There are many other block types available for different video services.
Adding a table as a block
There is a table block which supports the addition and deletion of rows and columns. It can also be useful to use “Edit as HTML” in order to make large changes if you are familiar with the HTML representation of a table. If you do work with the HTML don’t introduced elements that were not in the original table block or it may become impossible to edit with the normal block editor.
|Header 1||Header 2|
|Row 1, column 1||Row 1, column 2|
|Row 2, column 1||Row 2, column 2|
Adding a TablePress table
TablePress tables are maintained as separate objects which can then be included in your page or post by using a short code. TablePress has been installed with two complementary plugins to provide extra features and there is also a plugin that if, it has been enabled, will prevent those with a role of “Author” from editing or deleting other people’s tables. It is the responsibility of your site admin to enable it. TablePress itself is well documented at https://tablepress.org/ and there is a good video to get you started at https://www.youtube.com/watch?v=sQ2-yPIbxvg. The two complementary plugins are:
- https://tablepress.org/extensions/responsive-tables/ which makes use of extra parameters in the short codes to determine how responsiveness should be achieved
- https://tablepress.org/extensions/table-auto-import/ which allows the data for a table to be automatically imported. Please don’t set the auto-import to happen more frequently than you need and note that the variable WP_POST_REVISIONS referred in the documentation has been set to 10.
A gallery of images
There is a gallery block available to show a set of images. An example is shown below using images from this documentation.
Updating or deleting a post
Please note that you can only mess up your own work unless you are given admin privileges – in which case be careful!
Find the post on the “All Posts” or “All Pages” web page and if it is yours you will be able to edit it or delete it. Alternatively find the page or post by viewing the web site and then click on “Edit” by the page you want to work on. If you are editing an existing post which is just one large Classic Block then it is strongly recommended that you select “Convert to Blocks” beneath the of the block to split the block into multiple new blocks. Make your changes and click the large blue update button. To delete a page or other post then from the editor select the Document (rather than the Block) tab and click on “Move to Bin”
Throwing a post in the bin doesn’t mean it’s gone for ever. You can rescue it via the Posts option on the dashboard. Click on Bin (if there’s anything there) and you can sort through the rubbish. You will still be the owner.
For those who are happy with HTML
If you like to work at the HTML level click on the select the Code Editor from the icon at the top right of the editor window. Often more useful is just to show the current block as HTML using the same icon but this time the one with the block.
Don’t create your own tables as they will look a mess on a phone.
Don’t override fonts, font sizes or font colours – you can get out of phase with the visual theme if it’s changed at a later date.
Don’t use <span> or <div> commands, which may not display properly.
The font-awesome fonts are available. These can only be added by using the Code Editor or Edit as HTML . Choose one from the set of free icons, then enter <i class=”fas fa-<name of icon>”></i> where <name of icon> should be replaced by the actual icon name.
For example <i class=”fas fa-ambulance”></i> gives you the icon called ambulance which looks like . The editor won’t display the icon, but it should appear when you update and view the site.
A calendar is actually a special kind of post – though this is not obvious.. Typically the club web-admin will create the necessary calendars however if you have permission to create a post you can also create a calendar.
To add a calendar you need to:
- create a google calendar
- store your API key
- create a calendar widget to hold the google calendar
- add the widget to a page
There is currently a page called a page Calendar with a single line to insert a calendar widget with id of 208. If you now go to “Calendars/All Calendars” in the Dashboard you will see one calendar called “Croquet” with the shortcode you saw on the page called Calendar. The Calendar widget is actually a special kind of post – which is a bit confusing. The club website currently points to an empty calendar so you need to make it point to a calendar of yours.
To create a calendar you need a google account this account will already be associated with your personal google calendar but you don’t want to use that one. Go to https://www.google.com/calendar and look at the bottom of the left hand pane where it says “Other Calendars”. Click on the + icon then select “Create new calendar”, fill in the small form and click on “Create new calendar” give it a name and description and click on the blue button “Create calendar”. Google will then create the calendar and shortly after it will appear in a list of calendars on the left. Click on the calendar you have just created. Then tick the “Make available to public button” and if you want to allow specific people to be able to add events to the calendar then add them to the list under “Share with specific people” and select the correct permission – probably “make changes to events” then click on “Send”. Finally go to the “Integrate calendar” section and copy the Calendar ID field. The process is explained at https://docs.simplecalendar.io/ Add an entry to the calendar so that you will later recognise it as yours.
Now go to Dashboard/Calendars/Settings and in the Event Sources tab enter your Google API Key (replacing any existing one) and “Save Changes”. This is because you need your key to access a calendar belonging to you.
Next go to Calendars/All Calendars click on the existing Croquet calendar and select “Edit”. As mentioned above the Calendar widget is a special kind of post. The first section looks similar to other posts and should be left alone initially. This is then followed by the Yoast SEO section which accompanies all posts and right at the bottom are the “Calendar Settings”. Click on “g Google Calendar” on the left and replace the Calendar Id field with that of your newly created calendar, scroll back up and click on “Update” and now when you go to the Calendar menu entry you should see your calendar with the event you added. There are many options to explore in the calendar – but this should get you started.
The free Calendar plugin does not expose all that Google Calendar will do. An iframe could, in principle, be used to support embedded “native” calendars but iframes are not supported at the moment on multisite WordPress sites because of security concerns. There is a plugin to permit unfiltered-html for administrators and editors for which the description says: If you use this plugin your site will be hacked in one way or another if you allow anonymous users on the Internet to create blogs on your site. It’s very dangerous. Are you still 100% sure you want to use this plugin? It does not appear to be worth the risk.
First go to a regular google map at https://www.google.co.uk/maps and enter a search term to find your club. Normally the name of the club or its address will take you there and will display a red pin at the right place. Position the map as you want it – possibly not with the pin in the centre and set the scale as you see fit. Use the menu at the top left to select the map type and then further down the menu is a link “Share or embed map” click that and select the tab “Embed a map” and then “COPY HTML”. Now create a Shortcode Block, and paste the code in to the block. Replace the:
and replace everything after the next double quote with a closing square bracket.
Adding existing documents
It is not really a good idea to try to include MS Word as this is a proprietary format and will look really bad on a phone or tablet. The best way is to select all the text from your word document then paste into the page without formatting (Ctrl-Shift-v) then apply what formatting you actually need.
PDF (Portable Document Format)
There are three possible approaches with PDF: convert, embed or link.
You can process it in the same way as a Word document as explained above. This is the recommended procedure in most cases unless you have a large PDF file which is frequently replaced.
To link to a PDF file first make sure that it has a meaningful file name then simply use a File Block and follow the instructions.
A plugin exists to allow PDF documents to be embedded in a page. It is not currently included in this template but if any one has a good case to include it then it will be considered.