This repository contains a custom WordPress theme built for the Internet Archive's Political Ad Archive.
functions.php is a ball of wax right now, and would benefit from intelligent refactoring. This might mean breaking pieces of it into separate plugins.
We're going to implement an updated explore interface as shown https://projects.invisionapp.com/share/BQ7B3D4CM#/screens/158693517
(Note, this has been started already by @danletson but his hasn't been approved yet since it needs to incorporate the updated design).
We are going to update the advanced search pages to reflect this new design: https://projects.invisionapp.com/share/RY7CSVDDP#/screens
Tasks involved:
Add information about party affiliation for candidates.
The archive sync method in functions.php should be set up to trigger once per hour.
The initial theme setup code in functions.php should be set up to trigger once (on theme activation)
The date filter selections in the market map don't change the display or ad list. Fixing this will involve updating both the market counts API and the ads API so you can define date ranges.
The design footer has a section that lists out recent blog posts, this needs to be implemented.
Enable RSS feeds that are populated based on custom searches (in the same way that a data export or search can be queried).
Right now it is possible that the list of candidates and the list of markets and general number of ads being counted does not account for the 'published' status of an ad -- we should only be counting or communicating information for published ads.
Occasionally (due to overflow) there are gaps in the listing of airings.
The market map tries to render every single video thumbnail, which results in crippling browser strain on production where there are a few thousand ads. We need those results to come in page-by-page rather than all at once. Infinite scroll would be excellent, but even just a "load more" button would help to start with.
When I built the first version of this theme it was a little bit rushed to say the least. The HTML and CSS therefore is a little sloppy in places, and generally would benefit from a code review.
We need to be able to override sponsor type at the ad-sponsor level for certain cases
We want to be able to show off fact checked ads on the home page, as shown in https://projects.invisionapp.com/share/BQ7B3D4CM#/screens/158693517
There is javascript that runs on the front page market map that isn't needed; this results in API calls to get lists of ads which aren't used on the front page.
When looking at the detail for a particular ad, we'd like to be able to see the details of airings in context as now is possible in Tracey's interface. That is, something like this (though this would be improved with cities/states added)
When I click on a market "dot" on the home page right now it just turns the dot red. We should either have it go to the market map page with that market selected or alternatively have it link to a search page for that market.
Implement the new data download as designed on https://projects.invisionapp.com/share/RY7CSVDDP#/screens/159900678
Right now on the market map this button appears even if you aren't focused in on a specific market - it should only appear if you're focused.
Someone who knows wordpress can figure out how to get the initial setup done, but some of the theme specific setup steps are very opaque right now. Lets fix that
Right now the only way to search is to hit enter, but we should have an explicit "search" button like we have on advanced search.
Advanced search and basic search are on the same page; if advanced search filters exist the advanced search form should appear and that is the query that should be run.
This tends to happen on the "Ads since July 1st" tab.
When you click on a market the dot turns red, but if the market is "focused" via URL the map doesn't reflect that state.
http://politicaladarchive.org/ad/PolAd_JebBush_qyb0m/
Is there just not sponsor data has it not been added yet?
Current "market" descriptions are single cities, which are not names of markets. This is confusing for users who don't necessarily know, for example, that Boston = New Hampshire. We need to display the Nielsen market names for the "market" visualizations. Here is a link to Nielsen market names:
Alternatively, we could change the word "market" in visualization to "location," and then the display is for the city/state where our recording info is located.
We should talk this through.
The home page is going to now incorporate a new summary map which will give a snapshot of our dataset: https://projects.invisionapp.com/share/BQ7B3D4CM#/screens/158693517
There's gonna be a new page in the political ad archive: https://projects.invisionapp.com/share/J27AP1VYM#/screens/158459047_Market_Map_01
The advanced search design was made without accounting for where results should render; we should tweak that design to allow for a good place to load the results.
Right now partner metadata is simply a list of external posts; for the first version the plan is simply to use ACF to list out those posts, where the admin has to populate the content.
There is one special case, which is the Center for Public Integrity graphs. I'm going to break that piece into a separate task since it represents a different set of needs and is significantly more complex than the other pieces of partner data.
We should adjust the padding and prevent margin-bleed on mobile
Right now if you click "Search" it loads results below the fold; the user should be automatically scrolled down to where the results are being loaded.
We want to make some changes to the current home page explore:
We have more granular information about "message" of ads for general elections, showing whether a particular "mixed" ad is "pro" one candidate and "anti" the other. We need to think about if we want to display/make available and how.
We have various data that we will be associating with political ads that come from our partners. They should eventually be automatically loaded, but for now we will simply want to use a single ACF repeater with the following fields:
The type will simply determine which logo is shown on the design.
This may be by design, but should be discussed -- on the Market Map page when you filter the dates to only show counts from a date range, the list of ads does not change to only show ads aired during that new date range.
The "ad card" on the front page needs to incorporate sponsor and sponsor type as shown on this mockup: https://projects.invisionapp.com/share/BQ7B3D4CM#/screens/158693517
There are possibly some technical challenges around correcting this without using inefficient queries, but the air counts when viewing ads filtered by market / date range show the TOTAL air count for that ad, not only airings within that filter. This might be confusing to the user and doesn't make it as easy to fully understand the airings.
I see the times aired are UTC. Would it be possible to add the local time , or the time zone, for the download?
Right now our designs are spread across several places -- they will continue to be, but we should have them in this repository as well for easy reference purposes.
Sponsor type renders the code, not the friendly label (e.g. candcmte vs Candidate Committee). This happens in most places on the site; should probably be fixed at the model level.
The "single.php" has not been built yet, but should be
The front page featured post text is colored but should be black.
The current front page design does not reflect the latest designs (which have a featured ad as well as a featured blog post).
The following front page components should be editiable via Advanced Custom Fields:
On the front end "explore" interface there are cases where a candidate is listed as having "null" ads rather than "0" ads.
This should be corrected on the API level, but may be worth tweaking the frontend logic too; "null" should be interpreted as 0 rather than converted to a string.
On that note, candidates should not be rendered if they are not being marked as having ads.
The following pages need to be updated to support mobile (and, where trivial, tablet)
Right now the tablet view of the front page has the sponsor name and candidate stacked on top of each other (as it is on desktop view). The design has them next to each other.
This is how it looks:
This is how it should look:
When the theme was initially created I just went nuts and created an empty file per potential part.
Lets slim it down to only what is actually used.
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
Django
The Web framework for perfectionists with deadlines.
Laravel
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
Microsoft
Open source projects and samples from Microsoft.
Google
Google ❤️ Open Source for everyone.
Alibaba
Alibaba Open Source for everyone
D3
Data-Driven Documents codes.
Tencent
China tencent open source team.
