1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
Setup on ArchLinux:
===================
1) Install Apache, MySQL, PHP, and Subversion
# pacman -Sy apache mysql php subversion
2) Set a local 'hostname' of 'aur'
- Edit /etc/hosts and append 'aur' to loopback address
127.0.0.1 localhost aur
3) Configure Apache
- Edit /etc/httpd/conf/httpd.conf and append the following:
Replace MYUSER with your username.
<VirtualHost aur:80>
Servername aur
DocumentRoot /home/MYUSER/aur/web/html
ErrorLog /var/log/httpd/aur-error.log
CustomLog /var/log/httpd/aur-access.log combined
<Directory /home/MYUSER/aur/web/html>
Options Indexes FollowSymLinks
AllowOverride All
</Directory>
</VirtualHost>
4) Configure PHP
- Edit /etc/php.ini and uncomment the mysql extension line:
extension=mysql.so
5) Configure MySQL
- Connect to the mysql client
# mysql -uroot
- Issue the following commands to the mysql client
mysql> create database AUR;
mysql> grant all privileges on AUR.* to aur@localhost
> identified by 'aur';
mysql> flush privileges;
mysql> quit
- Load the schema file
# mysql -uaur -p AUR < aur/support/schema/aur-schema.sql
(give password 'aur' at the prompt)
6) Check out the AUR project (using the MYUSER from above)
$ cd
$ svn co https://xentac.net/svn/aur/trunk aur
7) Point your browser to http://aur
Web Interface:
==============
Directory Layout:
-----------------
./html - DocumentRoot for AUR, where the PHP scripts live.
./html/css - CSS stylesheets
./html/images - Any AUR images live here.
./lib - Supporting PHP include files. Access denied to Apache.
Scripts:
--------
- lib/aur.inc
This is where we can stick functions that can be shared
between the various scripts. Also a good place to put the
MySQL authentication variables since it should live outside
the DocumentRoot.
- html/login.php (probably index.php)
PHP script to handle logging users into the AUR web site. It
authenticates using the email address and a password against
the Users table. Once authenticated, a session id is generated
and stored in the Sessions table and sent as a cookie to the
user's browser.
- html/logout.php
PHP script to logout. It clears the session id from the
Sessions table and unsets the cookie.
- html/account.php
PHP script to handle registering for a new account. It prompts
the visitor for account information: Email, password, real name,
irc nick. The info is recorded in the Users table. Perhaps later,
we can add a preferences field that allows the user to request to
be notified when new packages are submitted so that they can cast
votes for them?
If a TU is logged into the system, they can edit accounts and set
the account type (regular user or TU). If a Dev is logged in, they
can also set the account type to Dev. TUs and Devs are able to
delete accounts. If an account is deleted, all "Unsupported"
packages are orphaned (the Users.ID field in the UnsupportedPackages
table is set to Null).
- html/pkgsearch.php
PHP script to search the package database. It should support
searching by location ("unsupported", "AUR", "extra"), name,
category, maintainer, popularity, etc. It should resemble the
packages.php script on archlinux.org. A checkbox should be
included next to each package to allow users to flag a package
out of date.
- html/pkgvote.php
The PHP script that handles voting for packages. It works like
the search script above to provide a list of packages (maybe by
location only?) with a checkbox for the user to register their
'yes' vote. It should probably only list 50-ish packages per page
and allow the user to vote a page at a time. Each page contains a
'Continue' button to advance to the next list of packages. At the
final page, a summary is presented with a 'Cast Vote' button. Once
the vote is cast, the PackageVotes table is first cleared for that
User and then all new entries are added for the new vote (this will
be easier than trying to figure out if the vote has changed for a
particular package).
- html/pkgmgmnt.php
The PHP script for managing packages. It provides a list of
packages under the management of the logged in user (normal or
TU). The user can edit the package information stored in the
database such as the description, url, category, and location
(a TU can move it to/from "unsupported" and the "AUR"). This
is where TUs can adopt packages that are in the "unsupported"
area.
- html/pkgsubmit.php
This is the PHP script that allows users to upload a new package.
The package format will be a tgz containing the PKGBUILD,
scriptlets, and patches necessary to build the package from
source. Initially, the user submitting the package can select
its category (network, devel, etc) but that can be modified
later by the adopting TU. The script makes appropriate entries
into the database (and perhaps notifies interested users of the
new package - see question above).
New terms/definitions:
======================
TU - No change (trusted by the community, if anyone asks what trust
means)
TUR - renamed to Arch User-community Repo (AUR) (so we can use -u for
versions)
Incoming - renamed to "Unsupported"
|
