project overview: - radford.edu · web viewwe will be creating an aesthetically pleasing joomla...

Table of Contents

THE IT CROWD Association of Computing Machinery User Manual Page | 1

Table of Contents

INTRODUCTION..........................................................................................................................3 PROJECT OVERVIEW:....................................................................................................................3 PROJECT SCOPE AND REQUIREMENTS:.......................................................................................3APPLICATION CONTROL:...............................................................................................................4ABOUT THE CREATORS:................................................................................................................5HELP DESK INFORMATION:...........................................................................................................6PROJECT REFERENCES:.................................................................................................................6ACRONYMS AND ABBREVIATIONS:...............................................................................................6

USING THE USER’S SYSTEM....................................................................................................71. VIEW HISTORY:........................................................................................................................82. VIEW OFFICERS.........................................................................................................................83. LOGIN TO EDIT ACM WEBPAGE...............................................................................................94. VIEW YOUTUBE TUTORIALS.....................................................................................................95. SUBMIT A FILE........................................................................................................................106. DOWNLOAD A GAME..............................................................................................................11

6.2 Download Game continue................................................................................................117. VIEW CALENDAR....................................................................................................................128. VIEW PHOTOS........................................................................................................................139. EXIT........................................................................................................................................15

USING THE ADMIN SYSTEM..................................................................................................161. LOGGING IN:.......................................................................................................................162. UPATING AN ARTICLE:.......................................................................................................173. UPLOADING GAMES TO THE GAME REPOSITORY:.............................................................184. ACCOUNT MANAGEMENT:.................................................................................................205. PHOTO MANAGEMENT:......................................................................................................206. ADDING LINKS TO LINKS OF INTEREST.............................................................................237. LOGGING OUT:...................................................................................................................23

BACKSIDE NAVIGATION........................................................................................................241. USER MANAGEMENT.........................................................................................................252. YOUTUBE TUTORIALS........................................................................................................263. TEMPLATE..........................................................................................................................274. GOOGLE CALENDAR...........................................................................................................285. PHOTOS..............................................................................................................................29

THE IT CROWD Association of Computing Machinery User Manual

Table of Contents

Page | 2

Introduction

Project overview:The purpose of this project is to create a new Association for Computing Machinery (ACM) website for the Radford University chapter. This Content Management System (CMS) will allow anyone at Radford University, the ability to find information not only about the current officers, but also the past ones. In addition to officer information, it will provide upcoming events and hopefully the opportunity to display some of the ITEC student's talents and projects.

Project Scope and Requirements:We will be creating an aesthetically pleasing Joomla CMS, inspired by the ACM National website, www.acm.org, colors and layout. In addition to this CMS colors and layout, we will be including the following features and functionalities:

A Radford Game Development Repository. This is a page where games created by our ITEC students can show off their talents as well as a place for games to be downloaded. Within this page, we will be including a splash image of the game, a description, and its authors.

A YouTube Tutorial Section created by ACM themselves. This section will either hold embedded links to these videos or smaller images of the video itself and when clicked on a bigger version pop ups within our page.

An ACM photo album, organized by school years. These photos will have brief captions under each of them and the ability to scroll through smaller images.

An embedded ACM Google Calendar on the main page. A section for "About ACM" on the main page. An events section that will display a bigger Google Calendar, as well as

listing past, upcoming events and brief descriptions about each other them. An ACM History section that allows visitors to see information about past

year officers and events.Within this CMS we will also be providing a place for members and non members to get additional information about the programming contest, UPE Radford Chapter and our ITEC Department, through the use of links in the top navigation bar on the main page and its additional pages.


Introduction

Page | 3

Introduction

Application Control:Users will be greeted with friendly colors on the site with a picture slide show on

the homepage and a navigation menu on the left column along with the Gmail Calendar. The color scheme remains the same throughout the system. The homepage will have an article below the slide show detailing upcoming events and other information ACM wishes to share. After clicking on one of the navigation links the user will continue to see the slide show with a new article(s) or other media displayed below it. If the user navigates to the ACM Tutorial section the user will be greeted with the slide show and a large YouTube video. Below the Video there will be thumbnail size of other videos on the site which the user can click on to replace the current video. Upon navigating to the Photos section of the site the user will be presented with a search option for photos or they can simply click on the photo album they wish to view. In each album there is one large photo that changes with the mouse moving over another photo.

If the user navigates to the Games link on the site they will see a table with files available for download sorted alphabetically. Logged in users will be able to add files to that list using the small (+) sign below the table. Users can change the sort by size, file name, or date changed (uploaded). Users who are visiting the site can submit files to a separate directory using the Submit File(s) link. The upload files option will now appear above the Gcalendar with instructions on what to and how to upload files. The super administrator can change what file types are not accepted and which are. They can also change whether uses can override existing file names.

When a user navigates to the Login link they will be prompted in the article for a username, their password, and whether or not if they want to be remembered at that computer. There is also links for the members to recover usernames and passwords. After logging in the user will see a similar but different menu on the left navigation bar. The Upload File(s) link disappears because they have no use for that feature of the site. In its place an Account Management link appears where users can change their usernames, passwords, and other things like languages and their email. They will also see edit features for all the documents allowing the user to bring up a text field below the current document and make changes to it and applying those changes instantly.


Introduction

About the Creators:


Introduction

William (DJ) Whelchel: Development Project Manager. He is currently a sophomore majoring in Software Engineering. In his spare time he loves playing video games, and working on computers and software. He also enjoys hunting, flying, and riding motorcycles. He was formally part of Army JROTC in at his High School (Knight BN). Originally he received a full rise scholarship to University of Portland Oregon on a ROTC scholarship but dropped it due to a change of heart and started to attend Radford.

Brittany Little: Project Planning Manager & Web Design. She is currently a senior graduating in May 2011 majoring in Website Development with a minor in Business Administration and Website Design. Currently she is doing an internship at Modea in Blacksburg, who has received a full time position with them after she graduates. She enjoys playing soccer, being outside; hiking, swimming, canoeing, and just hanging out with friends and family.

Stephen Mustgrave: Design Project Manager.He is currently a sophomore at Radford University perusing a degree in Computer Science with a Minor in Mathematics. He is a very social person and love building new connections however; he is also a very determined student. He is a brother in Theta Chi Fraternity at Radford and is involved in several charity events and philanthropies.

Philip Knouff: Requirements and Presentation Project Manager. He is currently a junior majoring in Computer Science and Technology with dual concentrations in Software Engineering and Database.

Help Desk Information:IT CROWD: The team of software enginerring students at Radford University who developed the ACM Content Management System (CMS) in Spring 2011. The team included William Whelcher, Brittany Little, Stephen Mustgrave and Philip Knouff. If any problems and issues develop, please contact us through emails.


Introduction

Tracy Lewis: The professor of the Software Enginerring Class in which IT Crowd was formed. She oversaw the project being developed throughout the development time in 2011. To contact Dr. Lewis you can email her at [email protected], sykpe her lewis-ru or call (540) 831-5358

Project References: Joomla website

o http://www.joomla.org ACM National website

o http://www.acm.org Dr. Tracy Lewis Software Engineering 01 User Manual

o http://www.radford.edu/~Softeng01

Acronyms and Abbreviations: ACM: Association of Computing Machinery CMS: Content Management System ITEC/IT: Information Technology RU: Radford University Joomla: A free and open-source Content Management System (CMS) written in

PHP.


Name EmailWilliam Whelchel [email protected] Little [email protected] Mustgrave [email protected] Knouff [email protected]

Page | 7

mailto:[email protected]

Using the User’s System

To access the ACM webpage users must type in the following URL: https://php.radford.edu/~acm

Home Page:



1+ 2

3

4

5 + 67

8

Page | 8

https://php.radford.edu/~acm


1. View History:First put the cursor on the ACM Info tab on the navigation bar. A drop down menu will display the user will click on the History tab. The user will then be brought to the following page:

2. View OfficersFirst put the cursor on the ACM Info tab on the navigation bar. A drop down menu will display the user will click on the Officers tab. The user will then be brought to the following page:



3. Login to edit ACM webpageFirst the user will click on the Login tab on the main navigation bar. The user will then be brought to the following page and depending if the user enters valid username/password, he or she will be allowed to login:

4. View YouTube TutorialsFirst the user will click on the Tutorials tab on the main navigation bar. The user can then select and view a YouTube video by simply clicking on it:



5. Submit a fileFirst put the cursor on the Games tab on the navigation bar. A drop down menu will display the user will click on the Submit File(s) tab. The user will then be brought to the following page:

If the user tries to submit a file type that is not supported by the system the following page will appear:



6. Download a GameFirst the user will click on the Games tab on the main navigation bar. The user can then select a game he or she would like to download:

6.2 Download Game continueAfter selecting which game to download the user will be presented with the following pop up. The best thing to do is save the file then open it:



7. View CalendarFirst the user will click on the Events tab on the main navigation bar. The user will be brought to a page where the following alert message will pop up:

The user must click “NO” in order for the calendar to work. After clicking no the Google Calendar will appear:



8. View PhotosFirst the user will click on the photo(s) tab on the main navigation bar. The user will then be brought to the following page:

Then the user will be allowed to select which photo album to view by clicking on it. The user will then be brought to the following page:



Then the user will have two options, to either view a particular photo or download it. If the user wants to download the photo then they will click the Download icon and the following message will appear:


DownloadIcon

Page | 15


If the user wishes to simply view the photo the user should just click on the photo. The photo will appear on the page:

9. ExitTo exit the webpage simply exit out of the browser.


Using the Admin System

1. Logging In:To log into the System the administrator should follow these steps

i. Navigate to the Systemii. Click the log in link on the left hand navigation menu

iii.

Enter a Valid User Name and password.

iv. After being redirected to the home page a new menu with some new navigations options. Submit File(s) from Step 1 has been removed for logged in users due to the fact it becomes unnecessary.



Page | 17


v. Navigation is the same as from explained in section Using the User’s System. A logged in administrator however is able to edit Articles, upload games, manage photos, and add links of Interest.

2. Upating an Article:i. Navigate to the article you wish to update (For the following pictures

provided the Officers Article will be updated.)ii. Click on the small Icon in the top left of the Article to bring up the Edit

Feature.iii. You will be prompted to make changes, cancel, or to save your changes.

There are many edit option available to Administrators. The Options Shown in the following Pictures are from a Super Admin level login.

iv. Section on Editing an Article: a) Changing an article is basically writing in Microsoft word

or any Text Editor. It handles uploading links, pictures, lists, and special characters.

v. The publishing section contains information about when, how and for how long the article will be displayed. There is an Option to select the article to be published on the main page, to hide the article or publish it to its



current location, Timing features to take down or publish an article at a specific time and date, along with the category and ordering of the article.

vi. Meta Data is the last section on Article Management and is only to be used if the search bar feature of the site is enabled. Metadata will be used for keywords for searches leading to the article.

3. Uploading Games to The Game Repository:i. Navigate to the Games section using the navigation bar (see Part 4)

ii. You be shown a Game Repository with similar features as shown in (INSERT_STEPHEN_REFERENCE) but with a few new options such as the red X. The red X allows the user to delete a file from the repository. Upon clicking



the X you will be prompted with a Yes to Delete or No to delete decision.

iii. If You click on the small grey + in the bottom left corner of the bow as shown in figure 7.b You will expand the repository Menu allowing yourself to add folders or files to the Repository. This Menu can be minimized back to the original 7.b Image with clicking on the same link.

iv. To upload a File simply browses on your local system for the file you wish to upload. The IT Crowd strongly recommends that all files either be .exe or some sort of .zip file (7zip, tar, etc...) Once the file has been selected click the link to the right of the Browse button to upload the file.

v. Creating a folder is easy. Enter the name of the folder you wish to create and press the Folder Icon. The folder will be created and can be navigated to by any user. Only Empty Folders may be deleted. To upload files into the folder you



must first navigate to the folder by clicking on it. To see instructions on how to upload a file sees 7.d.

4. Account Management:i. To change your password or account details Navigate to the Account

Management link.

ii. You be shown a section where you can change your email, password, time

settings, and languages (currently English-UK is the only language available)iii. *CAUTION* You do not need to enter your current password to change your

password. This is a security risk to the site if you leave your computer unattended. It is strongly recommend by the IT Crowd to lock or log off your computer whenever you walk away but plan to return and to remember to log out of the System before closing the browser. To see how to log out see part 9. Once all information is changed hit the save button up top.

5. Photo Management:i. Navigate to the Photos Link on the Menu and wait for the drop down menu

to show a link to Photo Management (For a Photo see part 4).ii. Click on Photo Management to be greeted with your user and photo

information. Most of the Time this can be ignored and you can proceed to the



subcategory Tab.

iii. This is where you would create a new album and provide a Description for the album. Be sure to select the Main Category up top before creating a new Category. All new Albums should fall under “Main”

a) Simply provide the album name and the description and hit “Create”

iv. Navigate to The Images Tab to add Photos to your new album (see 9.b)a) You need to select the Category you just created and set the

State to Published if you wish for the pictures to be published



immediately.

b) The IT Crowd recommends that all administrators use the Java Upload Feature below. This is the only way to upload multiple photos at once.

c) Select the Browse Button and navigate to the directory where your images are located at. Select all of the desired images and hit the Open button. Then click on the Upload button at the bottom of the Java Upload to begin the upload.

d) There is support for individual file uploads below the java Upload feature. This feature supports the use of adding a title and description to the photo.

v. To Edit albums you should navigate to the Subcategories section again (see 9.b) and under Select Category, select Main and then proceed to select the album you wish to edit. You can only Delete One Photo at a time or delete the entire Album



6. Adding Links To Links of Interesti. Hold your mouse over ACM Info link in the main menu (see Part 4). Wait for

the drop down menu to activate and scroll down to Links of Interest and a new drop down menu will activate, “Add Links”.

ii. Select the Category “Links of Interest” and provide the proper URL, Title, and the optional Description of the link.

iii.

Change published to Yes and hit save and the link will appear on The Links of Interest Page.

7. Logging Out:i. To log out of the system securely navigate to the Log Out Link from the

menu shown in Part 4.ii. You will be asked if you are sure you want to log out. To logout hit the

Logout Link


Backside Navigation

Backside Navigation

To log into the backside administration control panel, go to http://php.radford.edu/~acm/administrator.

Only the system administrator will have access to the backside administration for security reasons

Enter admin username and password. Once logged in, you will see the Joomla control panel:

Detailed information on the Joomla control panel, as well as other features, can be found in the Joomla documentation at: http://help.joomla.org/content/view/1440/233/ Specific aspects of the control

panel that are necessary for routine site administration will be covered here.


Backside Navigation

1. User managementi. Select the User Manager icon or go to Site > User Manager

ii. To edit an existing user, click on their name or select the check box next to their name and clicking Edit.

iii. To add a new user, click New

iv. Fill in the new user’s information (all fields are required).

The IT Crowd recommends that club officers be assigned to the Public Front-end > Publisher group

v. Click Save. The user will be added to the database and a confirmation email will be sent to their email address.

vi. You will be returned to the User Manager. Go to Site > Control Panel to return to the Joomla control panel.


Backside Navigation

2. YouTube tutorialsi. Go to Extensions > Module Manager and select ACM Tutorials from the list

of modules on the site.

ii. There are two settings for displaying videos in this module: Video id list and Video playlist id list.

a) Video id list will display specific videos based on their YouTube video id. For example, in http://www.youtube.com/watch?v=oWgkBBBi7uQ the blue text is the video id. Multiple video ID’s can be added. Just put each one on a new line.


Backside Navigation

b) Video playlist id will display videos from a playlist on YouTube (see http://www.google.com/support/youtube/bin/answer.py?answer=57792 for more information on creating a playlist). For example, in http://www.youtube.com/watch?v=QFLV40LbDXQ&playnext=1&list=PLC4EE4E12C9A8689E the blue text is the playlist id.

The IT Crowd recommends using Video playlist id list because adding/removing videos to/from a YouTube playlist is simpler than adding video id’s to the module

iii. When finished, click Save. You will be returned to the module manager. Go to Site > Control Panel to return to the Joomla control panel.

3. Templatei. Go to Extensions > Template Manager and select AS 002014 from the list

(this is the template for your site and is, by default, the only one installed).a) HTML: to manually edit the HTML for the site select Edit HTML

and the HTML file for the template will open up in a WYSIWYG editor. The images for the slideshow are contained in this file (in div id =”slideshow”). You can change the pictures in the slideshow by specifying the new image path and alternate text in the img tag(s).

b) CSS: Select Edit CSS and you will see the three CSS files for the site (template.css, slideshow.css and Joomla.css). Check the radio button by the file you wish to edit and click Edit. The file will open up in a WYSIWYG editor.

template.css is the main CSS file for the site and is where most of the layout, colors, fonts, etc. can be altered.

slideshow.css contains the style sheet for the image slideshow that is on the top of every page.


Backside Navigation

joomla.css is for Joomla functions (i.e. system messages, searches, etc.).

The permissions on the Radford University network drive that hosts your CMS are not set up correctly by default to be compatible with Joomla. When a file is modified and saved, the default permissions are applied to it. Joomla will override this when it updates files. However, it will not set them when a file is manually edited as in the case when

editing the HTML or CSS files. Therefore, you will have to update the permissions after you edit any of these files for your changes to take effect. There will be a shell script in the root of your network drive that can accomplish this. From a Unix terminal, type php_permissions.sh (this will take about two minutes) or you can manually set the permissions of just the file(s) you edited using chmod (directories need to be 711 and files need to be 644).

4. Google Calendari. If you wish to change the calendar that is displayed on the Events page of

your site, or would like to add another calendar, go to Components > GCalendar > GCalendars

ii. Click on a calendar name or click New.

a) Name: This is the name that will be associated with the calendarb) Calendar ID: This is the Google account that owns the

calendar(e.g. <username>@gmail.com)c) Magic Cookie: This is a variable that Google uses to control access

to your calendar. In order to use a calendar on this site, you will need to make the calendar public (in the calendar settings on Google) and get this variable from the Calendar Address field in the Calendar Details page on Google. Make sure to select the XML version.

iii. Click Save to be returned to the calendar manager. Go to Site > Control Panel to return to the Joomla control panel.


Backside Navigation

5. PhotosGo to Components > Phoca Gallery > Control Panel

i. Images: Display all of the images that have been uploaded (note: the images won’t initially be displayed in albums here, but instead sorted alphabetically. You can, however, filter them using the dropdown menus in the top right). Here you can add edit or delete any photos on the server.

The IT Crowd recommends photos and categories only be added from the front side because the gallery will not allow users logged into the front to manage photos added from the back side—even if it is the same user that uploaded them.

ii. Categories: Categories are used to create albums in the photo gallery and can be edited or deleted here.

The system will not allow the deletion of a category until all of the photos have been removed from it.


project overview: - radford.edu · web viewwe will be creating an aesthetically pleasing joomla...

Documents