Difference between revisions of "Pcmnet"

From ProgClub
Jump to: navigation, search
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Pcmnet is the ProgClub [http://www.progclub.net/ Member Net] and [http://progclub.mobi/ Mobile Net] software. That's the software that provides the Member Net and Mobile Net front pages and associated files (such as robots.txt). For other projects see [[Projects]].
+
Pcmnet is the ProgClub [[MemberNet]] (and [[MobileNet]]) software. That's the software that provides the MemberNet and MobileNet front pages and associated files (such as robots.txt). For other projects see [[Projects]].
  
 
== Project status ==
 
== Project status ==
Line 13: Line 13:
  
 
All contributors have agreed to the terms of the [[ProgClub:Copyrights#ProgClub_projects|Contributor License Agreement]]. This excludes any upstream contributors who tend to have different administrative frameworks.
 
All contributors have agreed to the terms of the [[ProgClub:Copyrights#ProgClub_projects|Contributor License Agreement]]. This excludes any upstream contributors who tend to have different administrative frameworks.
 +
 +
Upstream contributors:
 +
 +
* [http://www.scriptiny.com/2009/03/table-sorter/ Michael Leigeber]
  
 
== Copyright ==
 
== Copyright ==
  
Copyright 2011, [[Pcmnet#Contributors|Contributors]]. Licensed under the [[New BSD license]].
+
Copyright 2011-2012, [[Pcmnet#Contributors|Contributors]]. Licensed under the [[New BSD license]].
 +
 
 +
Pcmnet uses the TinyTable JavaScript Table Sorter which is licensed under the [http://creativecommons.org/licenses/by/3.0/us/ creative commons license].
  
 
== Source code ==
 
== Source code ==
Line 22: Line 28:
 
The repository can be browsed online:
 
The repository can be browsed online:
  
  http://www.progclub.org/pcrepo/pcmnet/
+
  https://www.progclub.org/pcrepo/pcmnet/trunk
  
 
The code for pcmnet is publicly available from svn:
 
The code for pcmnet is publicly available from svn:
  
  http://www.progclub.org/svnro/pcrepo/pcmnet/tags/latest
+
  https://www.progclub.org/svn/pcrepo/pcmnet/tags/latest
  
 
Or privately available for read-write access:
 
Or privately available for read-write access:
Line 34: Line 40:
 
== Links ==
 
== Links ==
  
* [http://www.progclub.net/ Member Net]
+
* [https://www.progclub.net/ MemberNet]
* [http://www.progclub.net/dev/home/ Member Net dev]
+
* [https://www.progclub.net/dev/home/ MemberNet dev]
* [http://progclub.mobi/ Mobile Net]
+
* [https://progclub.mobi/ MobileNet]
* [http://progclub.mobi/dev/home/ Mobile Net dev]
+
* [https://progclub.mobi/dev/home/ MobileNet dev]
 +
 
 +
== Debugging ==
 +
 
 +
I've configured the progclub.net web-server, honesty, so that you can watch the web-logs yourself. SSH to key720@honesty.progclub.net and then run the command:
 +
 
 +
$ tail -f /var/log/apache2/error.log
 +
 
 +
= Tasks =
  
 
== TODO ==
 
== TODO ==
  
 
Things to do, in rough order of priority:
 
Things to do, in rough order of priority:
 
+
* New sidebar menus. The menus on the ProgClub wiki have been changed and MemberNet should be updated with the new navigation design.
* Fix UTC offset for daylight savings time
+
* Fix link to W3C validation service.
** The date is hardcoded as the UTC offset as +10, but Sydney is +10 or +11 depending on daylight savings or not. This should be fixed. (hint: subtract the UTC date from the local date).
+
** Pass in the requested URL, not hardcoded. If there is no requested URL (e.g. run from command line) then pass in https://www.progclub.net/home/
* Refactor with render_member_list function
+
* Show the age of the last modified and oldest file files. E.g. 1 hour ago, 2 days ago, 3 months ago, etc.
** Refactor "member list" so that both mobile net and member net use the same function to generate their list, passing in "public_html" or "public_mobile" to the function. The function should go in the file pcmnet/common/member_list.php and be included from pcmnet/member/home/index.php and pcmnet/mobile/home/index.php
+
* Client-side table sorting on mobile net
* Relative URLs for member pages
+
** Allow the user to click on table headings to sort by either Member, Last Modified or Oldest File. Do the sorting in JavaScript.
** The generated URLs are fully qualified in the <a> tag, but it would be better if you didn't do that. Instead use a relative URL. So instead of http://www.progclub.mobi/~key720/ it would just be /~key720/ -- that will integrate better with our sites.
 
* Output the member list as an HTML table
 
* Show last modified date (of most recently modified file)
 
** In the HTML table include a 'last updated' field. Get the date of the 'last update' by looking at every file in the public_html (or public_mobile) directory, including subdirectories, and checking its last modified time. The table headings will then be "Member" and "Last updated".
 
* Client-side table sorting
 
** Allow the user to click on table headings to sort by either Member or Last Updated. Do the sorting in JavaScript. Talk on the ProgClub list about how to do this when you're up to it.
 
 
 
[[Category:TODO]]
 
  
 
== Done ==
 
== Done ==
  
 
Stuff that's done. Latest stuff on top.
 
Stuff that's done. Latest stuff on top.
 +
* [[User:John|JE]] 2012-08-29: "Member Net" to "MemberNet" and "Mobile Net" to "MobileNet" on the doco. I've found myself preferring "MemberNet" to "Member Net".
 +
* [[User:Key|JN]] 2012-08-29: "Member Net" to "MemberNet" and "Mobile Net" to "MobileNet" on the applications.
 +
* [[User:John|JE]] 2011-12-10: fixed oldest file filemtime/fileatime bug
 +
* [[User:John|JE]] 2011-12-10: doco on the member net/mobile net home pages with a link to this pcmnet project page explaining what the software does
 +
* [[User:Key|JN]] 2011-12-08: Fixed HTML validation errors
 +
* [[User:Key|JN]] 2011-12-06: Show the oldest file field
 +
* [[User:Key|JN]] 2011-12-05: Members with empty directories not shown
 +
* [[User:Key|JN]] 2011-12-02: Show last modified date (of most recently modified file)
 +
* [[User:Key|JN]] 2011-12-01: Client-side table sorting
 +
* [[User:Key|JN]] 2011-12-01: Output the member list as an HTML table
 +
* [[User:Key|JN]] 2011-12-01: Relative URLs for member pages
 +
* [[User:Key|JN]] 2011-12-01: Refactor with render_member_list function
 +
* [[User:Key|JN]] 2011-12-01: Fix UTC offset for daylight savings time
 
* [[User:Key|JN]] 2011-11-30: Sort members alphabetically
 
* [[User:Key|JN]] 2011-11-30: Sort members alphabetically
* [[User:Key|JN]] 2011-11-30: Update data/time of render at bottom of page
+
* [[User:Key|JN]] 2011-11-30: Update date/time of render at bottom of page
 
* [[User:John|JE]] 2011-08-22: renamed 'normal' to 'member' so as to be more consistent
 
* [[User:John|JE]] 2011-08-22: renamed 'normal' to 'member' so as to be more consistent
 
* [[User:John|JE]] 2011-08-22: created project page (project had previously been released)
 
* [[User:John|JE]] 2011-08-22: created project page (project had previously been released)
Line 69: Line 88:
 
If you are interested in incorporating ProgClub pcmnet into your project, here's what you need to know:
 
If you are interested in incorporating ProgClub pcmnet into your project, here's what you need to know:
  
Well, there's not really very much to this project. If there's something you're interested in probably just copy and paste it from [http://www.progclub.org/pcrepo/pcmnet/trunk pcrepo].
+
Well, there's not really very much to this project. If there's something you're interested in probably just copy and paste it from [https://www.progclub.org/pcrepo/pcmnet/trunk pcrepo].

Latest revision as of 02:15, 21 May 2018

Pcmnet is the ProgClub MemberNet (and MobileNet) software. That's the software that provides the MemberNet and MobileNet front pages and associated files (such as robots.txt). For other projects see Projects.

Project status

Released, but there's still stuff TODO.

Contributors

Members who have contributed to this project. Newest on top.

All contributors have agreed to the terms of the Contributor License Agreement. This excludes any upstream contributors who tend to have different administrative frameworks.

Upstream contributors:

Copyright

Copyright 2011-2012, Contributors. Licensed under the New BSD license.

Pcmnet uses the TinyTable JavaScript Table Sorter which is licensed under the creative commons license.

Source code

The repository can be browsed online:

https://www.progclub.org/pcrepo/pcmnet/trunk

The code for pcmnet is publicly available from svn:

https://www.progclub.org/svn/pcrepo/pcmnet/tags/latest

Or privately available for read-write access:

https://www.progclub.org/svn/pcrepo/pcmnet/trunk

Links

Debugging

I've configured the progclub.net web-server, honesty, so that you can watch the web-logs yourself. SSH to key720@honesty.progclub.net and then run the command:

$ tail -f /var/log/apache2/error.log

Tasks

TODO

Things to do, in rough order of priority:

  • New sidebar menus. The menus on the ProgClub wiki have been changed and MemberNet should be updated with the new navigation design.
  • Fix link to W3C validation service.
  • Show the age of the last modified and oldest file files. E.g. 1 hour ago, 2 days ago, 3 months ago, etc.
  • Client-side table sorting on mobile net
    • Allow the user to click on table headings to sort by either Member, Last Modified or Oldest File. Do the sorting in JavaScript.

Done

Stuff that's done. Latest stuff on top.

  • JE 2012-08-29: "Member Net" to "MemberNet" and "Mobile Net" to "MobileNet" on the doco. I've found myself preferring "MemberNet" to "Member Net".
  • JN 2012-08-29: "Member Net" to "MemberNet" and "Mobile Net" to "MobileNet" on the applications.
  • JE 2011-12-10: fixed oldest file filemtime/fileatime bug
  • JE 2011-12-10: doco on the member net/mobile net home pages with a link to this pcmnet project page explaining what the software does
  • JN 2011-12-08: Fixed HTML validation errors
  • JN 2011-12-06: Show the oldest file field
  • JN 2011-12-05: Members with empty directories not shown
  • JN 2011-12-02: Show last modified date (of most recently modified file)
  • JN 2011-12-01: Client-side table sorting
  • JN 2011-12-01: Output the member list as an HTML table
  • JN 2011-12-01: Relative URLs for member pages
  • JN 2011-12-01: Refactor with render_member_list function
  • JN 2011-12-01: Fix UTC offset for daylight savings time
  • JN 2011-11-30: Sort members alphabetically
  • JN 2011-11-30: Update date/time of render at bottom of page
  • JE 2011-08-22: renamed 'normal' to 'member' so as to be more consistent
  • JE 2011-08-22: created project page (project had previously been released)

Notes for implementers

If you are interested in incorporating ProgClub pcmnet into your project, here's what you need to know:

Well, there's not really very much to this project. If there's something you're interested in probably just copy and paste it from pcrepo.