|
So once you are happy with the menu items you have for your menu, there is one last thing for you to do.
|
|
-Go to admin>theme>configure layouts
|
+Go to __Admin > Theme > Configure layouts__ |
|
You will see the default setting for the layout of your site, and any others you have installed.
|
|
-Choose to 'edit this layout'(s) you want to have the menu on. Scroll down to the bottom of the page, to the assign column module tab.
|
+Choose to __Edit this layout(s)__ you want to have the menu on. Scroll down to the bottom of the page, to the assign column module tab. |
|
-In the drop down field for 'module' you should see the name for your admin menu.
|
+In the drop down field for __Module__ you should see the name for your admin menu. |
|
Select it, choose a position, and order if this is important to you.
|
|
The __key here is to select administrators in the groups box__ almost at the bottom of the page, and my recommendation is to apply it to all layouts - because you don't want to go off and work on one of the packages and either not be able to get back or not be able to insert images or whatever you feel is necessary that you added to your admin menu.
|
|
|
-!!!~~red:How do I create a link to another wiki page?~~
|
+--- |
|
-On the page that you want to link from, put 2 open parentheses around each end of the word.
|
-(I haven't worked out how to 'escape the code' and show this without the wiki wanting to link the example too - see: )
|
-((yourword))
|
|
-I'll try by spreading the example out:
|
-( (yourword) )
|
-but you will have to take the spaces out from the parentheses.
|
+!!! ~~#2f89fa:How do I change what boxes/widgets/modules are showing on my site?~~ |
|
+First let me say that you can have a different layout for (at least) each different core package that you choose to install (wiki, blogs, boards etc). |
+ |
+You would go to __Admin > Themes > Configure Layout Options__ |
+ |
+Here you will find the layouts of all the packages that you have installed. |
+ |
+Scroll down to the one you want. Click on __'edit this layout'__ above the section. |
+ |
+You will see the various parts of your page - column(s), top area and bottom areas. |
+ |
+*To delete a module - click on the shredder |
+*To change the position of a module - use the arrows |
+*(If it is a custom module (see above 'How do I add my own html code to a box/widget?') then you will see an edit button too.) |
+ |
+To add a new module scroll down to the bottom of the page |
+ |
+Choose your Module from the drop down box |
+ |
+*Choose where you want it to go in the Position field. |
+*Give it a title |
+*Choose the order in which it will appear in the section that you would like to add it to. |
+ |
+*Select the groups of users who can see this module if you want to. |
+ |
+NOTE: |
+Admins by default see all modules. If you want to change this see ((The Absolute Beginners Guide 2.0#IsthereanywaytoturnoffmodulesforAdmins|Is there any way to turn off modules for Admins)) |
+ |
+Registered users inherent Anonymous permissions too. See ((The Absolute Beginners Guide 2.0#Registereduserscanstillseemodules|Registered users can still see modules)) |
+ |
+ |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I create my own menu?~~ |
+ |
+See: ((The Absolute Beginners Guide 2.0#HowdoIblockpeopleregisteredusersfromsee|How do I block people (registered users) from seeing menu's and assign permissions?)) in this guide. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I escape code?~~ |
+ |
+See: How do I get code to show in a page instead of activating? |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I get messages sent to my email (without always having to log in to the site to read them)?~~ |
+ |
+Go to your user profile by clicking on your user name under the log in box or via __Home page > List Users__ click on your name; choose __preferences__ (the cog icon) and __User Messages__. Select your choice for __send an email__. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I get help?~~ |
+ |
+This will depend on what type of help you need. Leaving a post in the __forum__'s at present may not be the most expedient method of communication. |
+ |
+If you have something that you think is going wrong with your site that shouldn't be (ie you are receiving error messages, White Screens etc) then register this 'Bug' at __SourceForge__. There are so many varieties of computers, databases and servers that the developers can't really test on all platforms. You will be helping the community by reporting your anomaly - just make sure you give as many details as you can. |
+ |
+Or if you are more technically savvy, login to the Bitweaver __Chat__ at Freenode. This is where the developers hang-out but be warned its predominantly tech-speak. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I find out how many visitors my site has?~~ |
+ |
+Included in Bitweaver is a statistics package. The data collection starts from the day the programme is installed. |
+ |
+Administration > Stats > Site Stats for statistics about your site packages and views or |
+ |
+Administration > Stats > Referer Stats for information about which sites refer to yours. |
+ |
+If you want to start your statistics collection again, you can run the installer to de-install the package and choose 'delete package content' too (which cleans out your database) and then re-install. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I know if someone has changed something on my site?~~ |
+ |
+To get noticed via email, go to __Admin > Kernel > Notification__ and select the event that you want to be notified for, choose the email address and you're done! |
+ |
+To see what happened on your site, go to Bitweaver's 'Action Log' in __Admin > Liberty > Action Logs__. This table lists all changes made to content. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I translate words that still show in English on my site?~~ |
+ |
+Go to __Admin > Languages > Edit Languages__. Select your language, check the __only untranslated__ box, and click on the __edit translations__ button. This will bring up a list indexed by letter. Make your changes on each/any page and __save__. |
+ |
+At the end of your changes you will be prompted to clear the language cache - this is important so that the changes show on your site. You may also need to clear your site cache as well: __Admin > Kernel > System Cache__ |
+ |
+To edit words or phrases that you wish to be translated differently simply leave the 'untranslated' field unchecked and you will get a very big listing of all the words/phrases. |
+ |
+If you'd like to help other users by your translation efforts, please see [http://www.bitweaver.org/wiki/TranslationTutorial|Bitweaver's translation tutorial.] |
+ |
+ |
+--- |
+ |
+ |
+!!!~~#2f89fa:Is there anyway to turn off modules (for Admins)?~~ |
+ |
+Yes! First go to __Theme Settings > Modules require membership__ and check the box. Then when you configure your layout assign the groups to any/all except admins. See ((The Absolute Beginners Guide 2.0#HowdoIchangewhatboxeswidgetsmodulesaresh|How do I change what boxes/ widgets / modules are showing on my site?)) |
+ |
+ |
+--- |
+ |
+ |
+!!!~~#2f89fa:Registered users can still see modules~~ |
+ |
+This is because registered users inherent the anonymous group permissions (for modules at least). |
+ |
+To work around this: |
+ |
+Create a new group in Admin > Users > Groups and Permissions (perhaps calling it "Not registered") |
+ |
+Edit the group in Admin > Permission Maintenance to assign the same permissions to it as 'anonymous'. |
+ |
+Go to 'List User' in your home menu and click on the 'Assign Permissions' icon for 'guest'. Then click on the 'Assign Permission' icon for the new group you created from the list at the bottom and change the default group to the same. |
+ |
+There is one more step, and that is to go (back) into Admin > Themes > Configure Module Options, and amend any modules that you want visible to the new unregistered user group (de-selecting 'Anonymous'). |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:The group permissions have changed~~ |
+ |
+Have you recently upgraded from 2.0 to 2.1? If so there have been a few changes in the databases and tables. |
+ |
+This means that the permissions that are in the __Admin > Users > Groups & Permissions__ are only for the packages you have chosen. The global list got too big to have everything itemised out, and lets face it, it gets tedious to have to wade through stuff you don't need. |
+ |
+So now when you select a new package to include in your Bitweaver site, you will then ALSO need to go to the 'Groups and Permissions' area and assign the relevant permissions. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What about anonymous visitors to my site?~~ |
+ |
+ |
+To ~~red:allow/disallow actions for anonymous visitors~~: see ((The Absolute Beginners Guide 2.0#HowdoIblockpeopleregisteredusersfromsee|How do I block people (registered users) from seeing menu's and assign permissions?)) in this guide for where in Bitweaver the permissions etc are. |
+ |
+To set the ~~red:homepage of your site~~: This was already possible to set during the installation of Bitweaver, but can be changed any time: go to __Kernel > Kernel settings > Homepage Settings__ and choose a package from the home page drop down box. The home page of your site will now be the starting page of chosen package. Then, some packages allow for a more specific setting on their respective settings page. |
+ |
+To choose a ~~red:specific page as home page~~ of your site: __Kernel > Kernel settings > Homepage Settings__. I chose __custom home__ in the home page drop down box, and then entered the internal URL for the single standalone page that I had made as a front page for my site. In this case: wiki/Welcome. Remember to click on the ''change preferences'' at the bottom of the page. |
+ |
+To ~~red:allow anonymous visitors to see one page~~ that belongs to an generally "forbidden" content type or package: Go to the page that is your home page and click on the __Assign permissions__ icon (usually in the top right). This allows you to assign permissions that override the global permissions for this one page. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What are those words in parentheses/ curly brackets? And how do I use them?~~ |
+ |
+These are helpful commands that are already programmed into the code so you don't have to. In Bitweaver, they are called __Data Plugins__. They are inserted in Wiki pages. For example: |
+ |
+{code}{COUNTDOWN}{code} |
+ |
+If you simply type this in your Wiki page as it is, a 'help' will pop up when you preview that page alerting you to the things that you need to add to it for it to work the way that it was programmed to do. This information is also present at your Wiki help tab during editing that page. So lets say that we wanted a countdown since the day we installed Bitweaver, then we would add details inside the parentheses, after the word 'countdown', to end up with: |
+ |
+{code}{COUNTDOWN enddate='Jul 16 2008' localtime='on' text='since I started to use Bitweaver'}{code} |
+ |
+A full list of what you have installed is on the __Wiki Help__ page in the __Data Plugins__ box. To install or uninstall these plugins, go to __Admin > Liberty > Plugins__. |
+ |
+(Note: {COUNTDOWN} will not work if you have chosen to cache your site.) |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What do all the terms mean?~~ |
+ |
+Bitweaver has a __core__ (required packages) - Kernel, Liberty, Storage, Themes, Users. |
+ |
+Then it has __packages__ that you can choose to activate or deactivate. Wiki, Blogs, Newsletters, Articles etc. |
+ |
+__Plugins__ can be added to enhance the package or core functionality. |
+ |
+__Modules__ are what get positioned in the layout of your site. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What is an Article? How do you use them?~~ |
+ |
+Here is an [http://www.bitweaver.org/wiki/ArticlesPackage|explanation]. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What is a Stencil?~~ |
+ |
+It's a way to make entering data into many same wiki pages uniform. A stencil is set up exactly how you want the data displayed (ie table or paragraph) and then a piece of code that is generated from your stencil is placed in your chosen wiki page, that prompts a person to input certain values during the edit process that when the page is saved renders these as per the manner that the stencil has been set up to do. |
+ |
+So for example you had several pages for family members to enter information about themselves, and you wanted to make them all look the same, you could generate a stencil with first name, surname, birthday, country and then put the code that this generates into individual family member pages for them to fill in when they edit it. |
+ |
+Note: at present it doesn't handle foreign language characters. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What is a Wiki Book?~~ |
+ |
+It is a collection of content from your Bitweaver site - not limited to your Wiki pages, presented like a book. Think of it as a publishing tool for a thesis or report. |
+ |
+One of the Wiki pages that is already in your installation of Bitweaver is __"How to create a Wiki Book"__ or you could just as simply click on __Wiki__ and __Create a Wiki book__ Its fairly straight forward. The page or content needs to be there first though. |
+ |
+If when you go to __Add content__ on the Wiki book page you only see Wiki pages and you know that you have an image or a board to add - use the drop down menu at the top of the page to find the other content types. |
+ |
+ |
+ |
+ |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What is caching?~~ |
+ |
+Caching is the saving of images, files or information without having to go back to the database where it is stored, too often. to get them afresh. It is useful when there is a lot to load on a page or site. |
+ |
+Bitweaver has caching for the content (that which is entered into the site) in __Kernel > System Cache__. There is also caching for the modules in __Themes > Configure:Layout Options__ - expand your assigned modules and enter a value there, or enter one when you assign a module. |
+ |
+Cache time is relative to how often one expects to need to see the information refreshed. A header - not so frequently as it is expected to stay the same, an rss feed perhaps 10 minutes - as how much more frequently would you check it than that? |
+ |
+The only modules that should *not* be cached are 'login' and the 'user' ones like 'user profile', 'user content' etc. A user would expect that if they made a change here it would show up automatically. |
+ |
+(Note: BW also has session times.) |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:What is the difference between tags, pigeonholes and categories?~~ |
+ |
+What they have in common is that they can be used to group content together, regardless of the content's type: - images, galleries, wiki pages, comments, blog postings etc can all be grouped together to one theme ie "last year's wedding". (Much like a wiki book - see above.) |
+ |
+The 'Tags Package' is everything you read at Wikipedia about tags. Users input keywords, they are displayed as a cloud or as a list. They are non-hierarchical. (Grouping of tags like del.icio.us is not possible (yet).) To put it another way, they are random words that the user decides to describe the content. They evolve with the users and the site. |
+ |
+'Pigeonholes' and 'Categories', on the other hand, are both categorization packages. The basic concept is a hierarchical one. 'Pigeonholes' is fundamentally better than 'Categories'. To see at the features go to __Admin > Pigeonholes > Settings__. |
+ |
+Categorisation is pre-determined (usually by the site administrator or those with permissions to do so). |
+ |
+Pigeonholes has more features and modules. You can display content that belongs to each other in a side module, or you can apply a different site style depending on the category as a couple of examples. |
+ |
+A source of confusion might be, that Categories and Pigeonholes are both category-packages, but only one of them is named like that. The reason for that is the modularity of Bitweaver. |
+ |
+See also: |
+* in this guide: ((The Absolute Beginners Guide 2.0#WhyaretheresomanypackagesinBitweaver|Why are there so many packages in Bitweaver?)) |
+* external: [http://www.usabilitypost.com/2008/10/17/categories-vs-tags/Categories vs Tags], by usabilitypost.com |
+ |
+ |
+--- |
+ |
+ |
+!!!~~#2f89fa:What package is what?~~ |
+ |
+See this page: [http://www.bitweaver.org/wiki/Bitweaver+Features|for explanations of the packages.] |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:Why are there so many packages in Bitweaver?~~ |
+ |
+There is not one package for each content type - there are many - "Packages are king!". |
+ |
+To handle images, you can use Fisheye, Gallery2 (?), or write your own package (and name it as you like). There isn't really one "Bitweaver image gallery package" or "Bitweaver categorization package". |
+ |
+If you write your own package you can name it for its function, subsequent packages normally adopt synonymous names. If you're writing a Tags package now or an Events package, there are two names that you probably wouldn't pick. (You can instead extend an existing package instead of writing one from scratch!) |
+ |
+Two other packages that overlap in function are 'Stars' and 'Recommends', as well as 'Search' and 'Ilike' |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:Where do I start? Where to from here?~~ |
+ |
+Now you are ready to select the packages that you need for your site. |
+ |
+Read the description of each and consider if you REALLY need it - focus on the main component(s) of your site - you can enable packages again in the future. |
+ |
+There is so much potential with this CMS that it will blow your mind. |
+ |
+ |
+ |
+^!!Wiki^ |
+ |
+ |
+!!! ~~#2f89fa:Do my headings have to be red?~~ |
+ |
+No. Red is the colour set as a default example if you are using wiki syntax for your site. You can choose any standard colour name or number such as: blue, purple, yellow, #2f89fa, #ff6600 and so on. |
+ |
+If instead, your wiki is set to html as the default and you have installed FCKeditor, your heading styles will be picked up from your css (cascading style sheet). To edit these you will need to know your way around your file system. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How can users upload images directly during edit?~~ |
+ |
+Yes! This is automatically a default in many of the packages. |
+ |
+However you may wish to go to Admin > Liberty > Liberty settings and check __Ajax attachments__ which allows the user to note the id immediately during the edit process so they can use it. While you are there check __Enforce content status__. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I add a document to a page or a posting?~~ |
+ |
+First you need to upload the document to a __Treasury__ gallery: go to __Create Gallery__ in the drop down Treasury menu and the rest is fairly explanatory. Then to put a document into it go to: Admin > Liberty > Liberty settings |
+ |
+__Treasury > Upload File__ |
+ |
+Enter a title (this effectively renames the file as this is what shows when you use the file on a page). Description is optional. Choose the gallery it is to go into. Click upload file. |
+ |
+Having done this Bitweaver will have assigned a numerical ID to it. To find out what this is, go to the gallery via the menu bar to __List Galleries__ (or if your installation shows the path, click on the gallery name). Choose the gallery and it will list all the contents. Notice the ID number - this is what you will want to copy and paste to the page you want to use the file in. |
+ |
+This makes a link to the file number 67 appear in the page. |
+ |
+{code}{file id=67}{code} |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I add an image to a page or a posting?~~ |
+ |
+There are two ways: either uploading directly to Fisheye, or if the site allows uploading during the edit of a page, article, blog post etc. |
+ |
+===Fisheye=== |
+ |
+Go to __Create Gallery__ in the drop down Fisheye menu and the rest is fairly explanatory. Then, to put an image into the gallery go to: __Fisheye > Upload Images__ |
+ |
+You will see title and description boxes, but may also see that there are options for how to handle the upload - like rotation and resizing. |
+Choose the gallery it is to go into. Click upload file. Having done this, Bitweaver will have assigned a numerical ID to it. It is displayed underneath the image for you to copy and use in pages or postings. |
+ |
+You can also go to the __Home Page__ drop down menu on the top menu bar to __All available content__ and scroll through to find newly uploaded image, as it is ordered by date. In any case, the code you're looking for looks something similar to: |
+ |
+{code}{attachment id=918}{code} |
+ |
+Pasting this into a page or posting means that the image number 918 will be displayed inline. Any attachment can be displayed like this. For images though there is an added feature - and that is the variable sizing. When you upload an image, Bitweaver processes it into five different sizes and saves the original too: ''icon, avatar, small, medium, large, original''. Following this standard you can __define the image size by__: |
+ |
+{code}{attachment id=918 size=icon}{code} |
+===During Edit=== |
+ |
+If this setting is enabled then you will see a tab behind the package that you are editing. Click on the tab, find your image and upload. |
+ |
+ |
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I create a link to another wiki page?~~ |
+ |
+On the page that you want to link from, put 2 open parentheses around each end of the word. |
+ |
+{code}((yourword)){code} |
When you save this page, this word will appear to want to create a link. Simply click on the word and it will take you to creating a new page.
|
|
|
-!!!~~red:How do I create a link to a board?~~
|
+--- |
+ |
+ |
+!!! ~~#2f89fa:How do I create a link to a board?~~ |
|
Create the board first.
|
|