6 $VERSION = '%%%VERSION%%%';
8 #find missing entries in this file with:
9 # for a in `ls *pm | cut -d. -f1`; do grep 'L<FS::'$a'>' ../FS.pm >/dev/null || echo "missing $a" ; done
16 FS - Freeside Perl modules
20 Freeside perl modules and CLI utilities.
22 =head2 Utility classes
24 L<FS::Schema> - Freeside database schema
26 L<FS::Setup> - Setup subroutines
28 L<FS::Conf> - Freeside configuration values
30 L<FS::ConfItem> - Freeside configuration option meta-data.
32 L<FS::ConfDefaults> - Freeside configuration default and available values
34 L<FS::UID> - User class (not yet OO)
36 L<FS::CurrentUser> - Package representing the current user
38 L<FS::CGI> - Non OO-subroutines for the web interface.
40 L<FS::Msgcat> - Message catalog
42 L<FS::SearchCache> - Search cache
44 L<FS::raddb> - RADIUS dictionary
46 L<FS::AccessRight> - Access control rights.
48 L<FS::Report> - Report data objects
50 L<FS::Report::Table> - Report data objects
52 L<FS::Report::Monthly> - Report data objects
54 L<FS::XMLRPC> - Backend XML::RPC server
56 L<FS::Misc> - Miscellaneous subroutines
58 L<FS::payby> - Payment types
62 =head2 Database record classes
64 L<FS::Record> - Database record base class
66 L<FS::m2m_Common> - Mixin class for classes in a many-to-many relationship
68 L<FS::m2name_Common> - Base class for tables with a related table listing names
70 L<FS::option_Common> - Base class for option sub-classes
72 L<FS::pkg_class> - Package class class
74 L<FS::payinfo_Mixin> - Mixin class for records in tables that contain payinfo.
76 L<FS::access_user> - Employees / internal users
78 L<FS::access_user_pref> - Employee preferences
80 L<FS::access_group> - Employee groups
82 L<FS::access_usergroup> - Employee group membership
84 L<FS::access_groupagent> - Group reseller access
86 L<FS::access_right> - Access rights
88 L<FS::svc_acct_pop> - POP (Point of Presence, not Post
89 Office Protocol) class
91 L<FS::part_pop_local> - Local calling area class
93 L<FS::part_referral> - Referral class
95 L<FS::cust_main_county> - Locale (tax rate) class
97 L<FS::cust_tax_exempt> - Tax exemption record class
99 L<FS::cust_tax_exempt_pkg> - Line-item specific tax exemption record class
101 L<FS::svc_Common> - Service base class
103 L<FS::svc_Parent_Mixin> - Mixin class for svc_ classes with a parent_svcnum field
105 L<FS::svc_acct> - Account (shell, RADIUS, POP3) class
107 L<FS::acct_snarf> - External mail account class
109 L<FS::radius_usergroup> - RADIUS groups
111 L<FS::svc_domain> - Domain class
113 L<FS::domain_record> - DNS zone entries
115 L<FS::registrar> - Domain registrar class
117 L<FS::svc_forward> - Mail forwarding class
119 L<FS::svc_www> - Web virtual host class.
121 L<FS::svc_broadband> - DSL, wireless and other broadband class.
123 L<FS::addr_block> - Address block class
125 L<FS::router> - Router class
127 L<FS::part_virtual_field> - Broadband virtual field class
129 L<FS::svc_phone> - Phone service class
131 L<FS::cdr> - Call Detail Record class
133 L<FS::cdr_calltype> - CDR calltype class
135 L<FS::cdr_carrier> - CDR carrier class
137 L<FS::cdr_upstream_rate> - CDR upstream rate class
139 L<FS::cdr_type> - CDR type class
141 L<FS::svc_external> - Externally tracked service class.
143 L<FS::inventory_class> - Inventory classes
145 L<FS::inventory_item> - Inventory items
147 L<FS::part_svc> - Service definition class
149 L<FS::part_svc_column> - Column constraint class
151 L<FS::export_svc> - Class linking service definitions (see L<FS::part_svc>)
152 with exports (see L<FS::part_export>)
154 L<FS::part_export> - External provisioning export class
156 L<FS::part_export_option> - Export option class
158 L<FS::pkg_class> - Package class class
160 L<FS::part_pkg> - Package definition class
162 L<FS::part_pkg_option> - Package definition option class
164 L<FS::pkg_svc> - Class linking package definitions (see L<FS::part_pkg>) with
165 service definitions (see L<FS::part_svc>)
167 L<FS::reg_code> - One-time registration codes
169 L<FS::reg_code_pkg> - Class linking registration codes (see L<FS::reg_code>) with package definitions (see L<FS::part_pkg>)
171 L<FS::rate> - Rate plans for call billing
173 L<FS::rate_region> - Rate regions for call billing
175 L<FS::rate_prefix> - Rate region prefixes for call billing
177 L<FS::rate_detail> - Rate plan detail for call billing
179 L<FS::agent> - Agent (reseller) class
181 L<FS::agent_type> - Agent type class
183 L<FS::type_pkgs> - Class linking agent types (see L<FS::agent_type>) with package definitions (see L<FS::part_pkg>)
185 L<FS::payment_gateway> - Payment gateway class
187 L<FS::payment_gateway_option> - Payment gateway option class
189 L<FS::agent_payment_gateway> - Agent payment gateway class
191 L<FS::cust_svc> - Service class
193 L<FS::cust_pkg> - Customer package class
195 L<FS::cust_pkg_option> - Customer package option class
197 L<FS::reason_type> - Reason type class
199 L<FS::reason> - Reason class
201 L<FS::cust_pkg_reason> - Package reason class
203 L<FS::cust_main> - Customer class
205 L<FS::cust_main_Mixin> - Mixin class for records that contain fields from cust_main
207 L<FS::cust_main_invoice> - Invoice destination class
209 L<FS::cust_main_note> - Customer note class
211 L<FS::banned_pay> - Banned payment information class
213 L<FS::cust_bill> - Invoice class
215 L<FS::cust_bill_pkg> - Invoice line item class
217 L<FS::cust_bill_pkg_detail> - Invoice line item detail class
219 L<FS::part_bill_event> - Invoice event definition class
221 L<FS::cust_bill_event> - Completed invoice event class
223 L<FS::cust_bill_ApplicationCommon> - Base class for bill application classes
225 L<FS::cust_pay> - Payment class
227 L<FS::cust_pay_void> - Voided payment class
229 L<FS::cust_bill_pay> - Payment application class
231 L<FS::cust_bill_pay_pkg> - Line-item specific payment application class
233 L<FS::cust_bill_pay_batch> - Batch payment application class
235 L<FS::cust_credit> - Credit class
237 L<FS::cust_refund> - Refund class
239 L<FS::cust_credit_refund> - Refund application to credit class
241 L<FS::cust_credit_bill> - Credit application to invoice class
243 L<FS::cust_credit_bill_pkg> - Line-item specific credit application to invoice class
245 L<FS::cust_pay_refund> - Refund application to payment class
247 L<FS::pay_batch> - Credit card transaction queue class
249 L<FS::cust_pay_batch> - Credit card transaction member queue class
251 L<FS::prepay_credit> - Prepaid "calling card" credit class.
253 L<FS::nas> - Network Access Server class
255 L<FS::port> - NAS port class
257 L<FS::session> - User login session class
259 L<FS::queue> - Job queue
261 L<FS::queue_arg> - Job arguments
263 L<FS::queue_depend> - Job dependencies
265 L<FS::msgcat> - Message catalogs
267 L<FS::clientapi_session>
269 L<FS::clientapi_session_field>
271 =head2 Historical database record classes
273 L<FS::h_Common> - History table base class
275 L<FS::h_cust_bill> - Historical record of customer tax changes (old-style)
277 L<FS::h_cust_svc> - Object method for h_cust_svc objects
279 L<FS::h_cust_tax_exempt> - Historical record of customer tax changes (old-style)
281 L<FS::h_domain_record> - Historical DNS entry objects
283 L<FS::h_svc_acct> - Historical account objects
285 L<FS::h_svc_broadband> - Historical broadband connection objects
287 L<FS::h_svc_domain> - Historical domain objects
289 L<FS::h_svc_external> - Historical externally tracked service objects
291 L<FS::h_svc_forward> - Historical mail forwarding alias objects
293 L<FS::h_svc_phone> - Historical phone number objects
295 L<FS::h_svc_www> - Historical web virtual host objects
301 L<FS::ClientAPI_SessionCache>
303 L<FS::ClientAPI::Signup>
305 L<FS::ClientAPI::passwd>
307 L<FS::ClientAPI::MyAccount>
309 L<FS::ClientAPI::Agent>
311 =head2 Remote API modules
319 L<FS::MailAdminServer> (deprecated in favor of the self-service server)
321 =head2 User Interface classes
323 L<FS::UI::Web> - Web user-interface class
325 L<FS::UI::bytecount> - Byte counter user-interface class
327 =head2 Command-line utilities
335 L<freeside-expiration-alerter>
339 L<freeside-cc-receipts-report>
341 L<freeside-credit-report>
343 L<freeside-receivables-report>
345 L<freeside-tax-report>
353 To quote perl(1), "If you're intending to read these straight through for the
354 first time, the suggested order will tend to reduce the number of forward
357 If you've never used OO modules before,
358 http://www.perl.com/doc/FMTEYEWTK/easy_objects.html might help you out.
362 Freeside is a billing and administration package for wired and wireless ISPs,
363 VoIP, hosting, service and content providers and other online businesses.
365 The Freeside home page is at <http://www.sisd.com/freeside>.
367 The main documentation is at <http://www.sisd.com/mediawiki>.
371 A mailing list for users is available. Send a blank message to
372 <freeside-users-subscribe@sisd.com> to subscribe.
374 A mailing list for developers is available. It is intended to be lower volume
375 and higher SNR than the users list. Send a blank message to
376 <freeside-devel-subscribe@sisd.com> to subscribe.
378 Commercial support is available; see
379 <http://www.sisd.com/freeside/commercial.html>.
383 Primarily Ivan Kohler, with help from many kind folks, including core
384 contributors Jeff Finucane, Kristian Hoffman, Jason Hall and Peter Bowen.
386 See the CREDITS file in the Freeside distribution for a (hopefully) complete
387 list and the individal files for details.
391 perl(1), main Freeside documentation at <http://www.sisd.com/mediawiki/>
395 Those modules which would be useful separately should be pulled out,
396 renamed appropriately and uploaded to CPAN. So far: DBIx::DBSchema, Net::SSH