Table of Contents

crateleftInternet and Web Development

Dec 4, 2013 (3 years and 9 months ago)

88 views

Table of Contents


THE IT CROWD Association of Computing Machinery User Manual

Page |
1















































Table of Contents


THE IT CROWD Association of Computing Machinery User Manual

Page |
2









INTRODUCTION

................................
................................
................................
.........................

3


P
ROJECT OVERVIEW
:

................................
................................
................................
..................

3


P
ROJECT
S
COPE AND
R
EQUIREMENTS
:

................................
................................
......................

3

A
PPLICATION
C
ONTROL
:

................................
................................
................................
.............

4

A
BOUT THE
C
REATORS
:

................................
................................
................................
..............

5

H
ELP
D
ESK
I
NFORMATION
:

................................
................................
................................
.........

6

P
ROJEC
T
R
EFERENCES
:
................................
................................
................................
................

6

A
CRONYMS AND
A
BBREVIATIONS
:

................................
................................
.............................

6

USING THE USER’S SYS
TEM

................................
................................
................................
..

7

1.

V
IEW
H
ISTORY
:

................................
................................
................................
......................

8

2.

V
IEW
O
FFI
CERS

................................
................................
................................
.......................

8

3.

L
OGIN TO EDIT
ACM

WEBPAGE

................................
................................
..............................

9

4.

V
IEW
Y
OU
T
UBE
T
UTORIALS

................................
................................
................................
...

9

5.

S
UBMIT A FILE

................................
................................
................................
.......................

10

6.

D
OWNLOAD A
G
AME

................................
................................
................................
.............

11

6.2 Downlo
ad Game continue

................................
................................
..............................

11

7.

V
IEW
C
ALENDAR

................................
................................
................................
...................

12

8.

V
IEW
P
HOTOS

................................
................................
................................
.......................

13

9.

E
XIT

................................
................................
................................
................................
.......

15

USING THE ADMIN SYST
EM
................................
................................
................................
.

16

1.

L
OGGING
I
N
:

................................
................................
................................
.....................

16

2.

U
PATING AN
A
RTICLE
:

................................
................................
................................
.....

17

3.

U
PLOADING
G
AMES TO
T
HE
G
AME
R
EPOSITORY
:

................................
...........................

18

4.

A
CCOUNT
M
ANAGEMENT
:

................................
................................
...............................

20

5.

P
HOTO
M
ANAGEMENT
:

................................
................................
................................
....

20

6.

A
DDING
L
INKS
T
O
L
INKS OF
I
NTEREST

................................
................................
............

23

7.

L
OGGING
O
UT
:

................................
................................
................................
.................

23

BACKSIDE NAVIGATION

................................
................................
................................
.......

24

1.


U
SER MANAGEMENT

................................
................................
................................
.........

25

2.

Y
OU
T
UBE TUTORIALS

................................
................................
................................
......

26

3.

T
EMPLATE

................................
................................
................................
........................

27

4.

G
OOGLE
C
ALENDAR

................................
................................
................................
.........

28

5.

P
HOTOS

................................
................................
................................
.............................

29





Table of Contents


Introduction


THE IT CROWD Association of Computing Machinery User Manual

Page |
3





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
abou
t 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 creat
ing 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 i
ts 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, organ
ized 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 disp
lay 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 providi
ng 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

Introduction


THE IT CROWD Association of Computing Machinery User Manual

Page |
4


Applicatio
n
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 ha
ve 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 t
he 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 na
vigating 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 phot
o.


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 so
rt 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 u
pload 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
Upl
oad 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
f
eatures 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


THE IT CROWD Association of Computing Machinery User Manual

Page |
5

About the Creators:





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
Plann
ing 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
cha
rity 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.

Introduction


THE IT CROWD Association of Computing Machinery User Manual

Page |
6

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 issue
s develop, please contact us through emails.



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
tlewis32@ra
dford.edu
, 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

Email

William Whelchel

wwhelchel@email.radford.edu

Brittany Little

blittle9@radford.edu

Stephen Mustgrave

smustgrave@radford.edu

Philip Knouff

pknouff@email.radford.edu

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
7




To access the ACM webpage users must type in the following URL:

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


Home Page:



Using

the User’s System

1+ 2

3

4

5 + 6

7

8

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
8



1
.

View History
:

First put the
cursor on the ACM Info tab on the navigation b
ar. A drop down menu will
displa
y the user will click on the History tab. The user
will then

be brought to the
following page:




2. View Officers

First put the cursor on the ACM Info tab on the navigation b
ar. A drop down menu will
displa
y the user will click on the
Officers tab
. The user
will then

be brought to the
following page:

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
9



3. Login to edit ACM webpage

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




4. View YouTube Tutorials

First 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:

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
10



5. Submit a file

First 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 pag
e:



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

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
11



6. Download a Game

First 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 continue

After 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:

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
12



7. View Calendar

First 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:

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
13





8. View Photos

First 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:

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

Page |
14



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:






Download

Icon

Using the
User’s System


THE IT CROWD Association of Computing Machinery User Manual

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. Exit

To exit the webpage simply exit out of the browser.




Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
16




1.

Logging In:

To log into the System the administrator should follow these steps

i.

Navigate to the System

ii.

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.


Using the Admin System

Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

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 w
ill 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

s
pecial characters.


v.

The publishing sect
ion contains information about when, how and for how
long the article will be displayed. There is an Option to select the article to
Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
1
8

be published on the main page, to hide the article or publish it to its
current location, Timing features to take down or p
ublish 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 ke
ywords 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
Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
19

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 b
ack 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
Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
20

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 detail
s 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 be
fore closing the browser. To see how to log out see part
9. Once all information is changed hit the save button up top
.

5.

Phot
o 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 Phot
o 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
Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
21

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
Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
22

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

Using the Admin System


THE IT CROWD Association of Computing Machinery User Manual

Page |
23

6.

Adding Links To Links of Interest

i.

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 logou
t hit the

Logout Link


Backside Navigation


THE IT CROWD Association of Computing Machinery User Manual

Page |
24



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


THE IT CROWD Association of Computing Machinery User Manual

Page |
25


1.

User management

i.

Select the Us
er 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 S
ite > Control Panel to
return to the Joomla control panel.



Backside Navigation


THE IT CROWD Association of Computing Machinery User Manual

Page |
26

2.

YouTube tutorials

i.

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


THE IT CROWD Association of Computing Machinery User Manual

Page |
27

b)

Video playlist id will display videos from a playlist on YouTube
(see
http://www.google.com/support/youtube/bin/answer.py?answer=5779
2 for more information on creating a playlist). For example, in
http://www.youtube.com/watch?v=QFLV40LbDXQ&playne
xt=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.

Template

i.

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 o
ne 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 ed
it 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.



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

Backside Navigation


THE IT CROWD Association of Computing Machinery User Manual

Page |
28


The permissions on the Radford University network drive that hosts your CMS are not set up correctly by default to be compati
ble with
Joomla. When a file is modified and saved, the default permissions are applied to it. Joomla will override this when it up
dates 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 ha
ve 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 nee
d to be 711 and files need to be 644).

4.

Google Calendar

i.

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 clic
k New.


a)

Name: This is the name that will be associated with the calendar

b)

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 ord
er 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 Sav
e to be returned to the calendar manager. Go to Site > Control Panel
to return to the Joomla control panel.


Backside Navigation


THE IT CROWD Association of Computing Machinery User Manual

Page |
29

5.

Photos

Go to Components > Phoca Gallery > Control Panel


i.

Images: Display all of the images that have been uploaded (note: the images
won’t initial
ly 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.