Tendenci provides a content feature called "Boxes" which enables you to incorporate various types of content, created using a WYSIWYG editor, onto a Page. Using Boxes can save you time and provide greater flexibility when working with your Tendenci website template.
Creating a Box
To create a Box, you must be logged in as a Superuser on your Tendenci AMS website. You will find Boxes under "Apps" -> "7. Layout" -> "Boxes" on the Tendenci Navigation Menu at the top of any page on your website:
To create a new box, click on the "+ Add box" button. This will take you to a form where you can enter a title that describes the box, and add content using the WYSIWYG editor labeled "Content". You can include text, images, media, and other types of content. The text formatting will be consistent with the heading styles defined in your website theme.
When you save your box, it will be automatically set to the "Active" publishing status, and you will be directed to a list view of all your created boxes.
Make note of the ID number assigned to the box you created. This will be the number used to add the box to your website. In the image above, there are 2 boxes numbered 1 and 2.
Add a Box to a Template
WARNING - This requires some basic knowledge of HTML and in some cases, CSS by accessing the Theme Editor. Making changes to the Theme Editor presents a risk of damaging and/or breaking the appearance and functionality of your website. You may not be able to fully restore damaged or deleted templates. We may or may not be able to help restore part or all of the files damaged and you will incur additional support charges to have us attempt this.
The code to add a box to a template is simple. From inside the Theme Editor, select the template you wish to add the box to and determine where you want to place the box.
Insert the code:
- {% load box_tags %} - This tag (line 19) will permit the loading of all the boxes in the boxes module. This is usually placed at the top of the template with the other tags.
- {% box x %} where x is the box ID number you wish to add.
Click the "Save Changes" button and refresh your browser cache. Navigate to the Page where you added the box to view the box.
Deleting a Box
To remove a box, simply delete the {% box x %} code that you added to the template in the theme editor and click "Save changes".
To delete a box entirely, follow these steps: Navigate to the "Apps" menu, select "7. Layout" and then click on "Boxes". This will take you to the Boxes Module, where you can select the box you want to delete and click on "Edit." Finally, choose "Delete" at the bottom of the page or set the box to "Inactive" in the Publishing Status drop-down to keep it private and hidden from the public.
Edit a Box
You can edit a Box by navigating through the Tendenci nav -- "Apps" -> "7. Layout" -> "Boxes". You can also edit a Box directly from the Page where the Box is located.
When logged in as a Superuser, you'll see an "Edit" option next to each Box when you're logged in. Simply click on it to make changes and save them for an immediate update.
Did this answer your question? If not, please contact our support team for more information.
Still Looking for an Answer?
Request a Help File we'll retrieve your answer right away
We are always looking for ways to simplify your life.
Contact us today with more ideas!
Join the Open-Source Community! Give us a Call at (281)497-6567
We want to help your organization succeed on the web.